Files

T

tupingr 6992f59cd2 refactor(arch): 信息架构升级 — 三层四角色控制面板 + 跨平台 task 交接协议

核心变化：
- 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>

2026-05-26 15:17:06 +08:00

5.8 KiB

Raw Permalink Blame History

name, description

name	description
share-context	一鸡多吃：将内部开发文档（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. 告知用户

## 一鸡多吃完成

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

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

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

注意事项

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

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

5.8 KiB Raw Permalink Blame History Unescape Escape