tupingr
6992f59cd2
核心变化： - dashboard.md 替代 DASHBOARD + ROADMAP，人类+Arch AI 唯一入口 - DECISIONS.md 人类决策入口，≤3 条待决策 - .ai/tasks/ 14 个独立 task 文件（Coder 8 + Tester 6），弱模型自包含可独立执行 - 旧 today/queue 归档，每个角色启动 ≤2 个文件 - ADR-012 跨平台「高模型指挥小模型」协作架构落地 - 知识库补全：L-002~005、P-004~005、ADR-011~012 - Arch AI 上下文资源管理硬约束写入 principles.md Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
137 lines
5.8 KiB
Markdown
137 lines
5.8 KiB
Markdown
---
|
||
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**: 将内部开发文档自动转化为对外分享内容，实现「开发即内容」的闭环
|