Files

T

tupingr 5b428d0810 chore(phase): Phase 1 收尾 — 一鸡多吃 + Dev工作台初始化 + Phase 2启动

- Phase 1 标记 100% 完成，Phase 2 标记 ACTIVE
- Dev AI 工作台重写：8个任务入队 + 依赖关系图
- 一鸡多吃：6篇对外分享文章（项目缘起/框架思路/阶段复盘/3篇决策故事）
- 新增 share-context Skill（内部文档→对外分享自动化）
- P01 文档同步更新（需求/架构/接口定义）

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-26 12:01:04 +08:00

4.4 KiB

Raw Blame History

name, description

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

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

功能

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

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

触发条件

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

执行步骤

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. 告知用户

## 一鸡多吃完成

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

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

### 分享目录
→ `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

注意事项

不是做完再写：开发过程中自动积累，阶段结束时批量产出
同一份工作，两种语言：内部文档是「给 AI 看的结构化数据」，对外文章是「给人看的故事」
保持真诚：有成功写成功，有失败写失败。读者能看出哪些是 PR 稿
去敏但不去肉：去掉敏感信息，但保留具体细节。一个没有细节的故事没有价值
链接内部来源：每篇文章底部可附「内部参考：ADR-XXX」但不暴露内部文件路径

Version: 1.0
Created: 2026-05-26
Based On: ErrLens 开发实践 — Phase 1 收尾时的「一鸡多吃」流程
Purpose: 将内部开发文档自动转化为对外分享内容，实现「开发即内容」的闭环

4.4 KiB Raw Blame History Unescape Escape