---
name: "share-context"
description: "一鸡多吃：将内部开发文档（ADR、阶段复盘、开发日志）翻译为对外分享文章。阶段收尾时或用户说「一鸡多吃」「同步分享」「发布分享」时调用。"
---

# 一鸡多吃 — 内部文档转对外分享 Skill

## 功能

将开发过程中积累的内部文档（架构决策、阶段完成记录、踩坑经验）翻译为对外可发布的分享文章，写入 `docs/share/` 目录。

**核心逻辑**：同一份工作，两种产出。内部文档（给 AI 看）→ 去敏 + 加故事 + 加思考过程 → 对外文章（给人看）。

## 触发条件

- 用户说「一鸡多吃」「同步分享」「发布分享」「更新分享」
- 阶段收尾时（Phase completion）
- 有新的 ADR 或重要决策产生后

## 执行步骤

### 0. 反向检查：知识库是否遗漏了有价值的洞察

**在扫描对外分享内容之前**，先检查是否有最近的开发讨论/决策/想法尚未写入知识库：

| 检查项 | 判断标准 | 写入目标 |
|--------|---------|---------|
| 近期是否有重要的架构讨论 | 讨论产生了「可复用的判断」或「方向性决策」 | `.ai/knowledge/decisions.md`（新 ADR） |
| 近期是否有反直觉的发现或错误 | 讨论产生了「原来以为…但其实…」的洞察 | `.ai/knowledge/lessons.md`（新 L-XXX） |
| 近期是否发现了可复用的模式 | 同样的做法出现了 2 次以上 | `.ai/knowledge/patterns.md`（新 P-XXX） |

**触发词**：当讨论中出现以下信号时，应主动提议记录：
- 「这个很有价值」「值得记下来」「下次遇到可以…」
- 「原来是这样」「之前没想到」「反直觉的是…」
- 领域术语的定义或边界划分（如「蜂群模式」「编排器-执行者」）

如果发现遗漏，**先补知识库，再执行后续步骤**。知识库是分享的源头——源头空了，一鸡多吃也无米下锅。

### 1. 扫描内部文档，识别可分享内容

按以下来源对比 `docs/share/` 已有内容，找出新增/变化：

| 内部来源 | 对应对外产出 | 判断标准 |
|---------|-------------|---------|
| `.ai/knowledge/decisions.md` 中的新 ADR | `phase-XX/决策故事_ADR-XXX.md` | 有新 ADR 且无对应故事文件 |
| `.ai/phases/phase-XX-*/completion.md` | `phase-XX/阶段复盘_XXX.md` | 阶段已完成且复盘文件为空/待写 |
| `.ai/knowledge/lessons.md` | 踩坑记录（融入复盘或独立） | 有新的经验教训记录 |
| `.ai/knowledge/journal/` | 开发周记 | 有新的日志文件 |

### 2. 确定本次要写的文章

列出待写文章清单，向用户确认优先级和范围。

### 3. 逐篇撰写

每篇文章遵循以下原则：

**内容要求**：
- 不只说「做了什么」，重点说「为什么这么选」
- 有具体的决策场景（当时遇到了什么问题）
- 有可复用的方法论（下次遇到类似情况怎么做）
- 有真实的踩坑和教训（不粉饰）
- 一句话总结（可引用/可传播）

**安全要求**：
- ❌ 不暴露 API 密钥、服务器地址、数据库连接串
- ❌ 不暴露真实用户名、手机号、微信号
- ❌ 不暴露未公开的第三方合作信息
- ✅ 技术方案可以详细写
- ✅ 决策过程可以完整写
- ✅ 思考逻辑可以展开写

**写作风格**：
- 第一人称（「我」），人类视角
- 像讲故事，不像写文档
- 目标读者是「对 AI 编程感兴趣的人」，不是机器
- 每篇 800-1500 字，独立可读

### 4. 更新分享目录

更新 `docs/share/README.md` 中的文章列表和状态。

### 5. 告知用户

```markdown
## 一鸡多吃完成

### 新增文章
| 文件 | 内容 |
|------|------|
| [文章名](路径) | 一句话描述 |

### 更新文章
| 文件 | 变更 |
|------|------|
| [文章名](路径) | 更新内容简述 |

### 分享目录
→ `docs/share/README.md`
```

## 文件结构

```
docs/share/
├── README.md                          # 分享目录索引
├── 00_项目缘起.md                      # 项目背景（一次性写完，后续微调）
├── 01_框架设计思路.md                  # 核心理念（一次性写完，后续微调）
├── phase-01/                          # Phase 1 分享内容
│   ├── 阶段复盘_基础搭建.md             # 阶段复盘
│   ├── 决策故事_ADR-007.md             # 信息架构决策
│   ├── 决策故事_ADR-009.md             # 人机协同决策
│   └── 决策故事_旧架构合并.md           # 旧架构合并决策
├── phase-02/                          # Phase 2 分享内容（待产生）
│   └── ...
└── templates/                         # 写作模板
    ├── 阶段复盘模板.md
    └── 决策故事模板.md
```

## 注意事项

1. **先入库，后分享**：Step 0 必须在 Step 1 之前执行。知识库是米缸，分享是做饭——米缸空了做不出饭
2. **不是做完再写**：开发过程中自动积累，阶段结束时批量产出
3. **同一份工作，两种语言**：内部文档是「给 AI 看的结构化数据」，对外文章是「给人看的故事」
4. **保持真诚**：有成功写成功，有失败写失败。读者能看出哪些是 PR 稿
5. **去敏但不去肉**：去掉敏感信息，但保留具体细节。一个没有细节的故事没有价值
6. **链接内部来源**：每篇文章底部可附「内部参考：ADR-XXX」但不暴露内部文件路径

---

**Version**: 1.1  
**Updated**: 2026-05-26 — 新增 Step 0「反向检查」，补上知识库摄入端  
**Created**: 2026-05-26  
**Based On**: ErrLens 开发实践 — Phase 1 收尾时的「一鸡多吃」流程  
**Purpose**: 将内部开发文档自动转化为对外分享内容，实现「开发即内容」的闭环