接手频道任务(实施会话用)
你没有上一个会话的记忆,也不需要。频道目录 + 设计文档是唯一事实来源,不要找用户复述背景。
开工三步(顺序固定)
- 读频道:
.local/agent-work/channel/<主题>/HANDOFF.md(用户没给主题就ls .local/agent-work/channel/列出让用户选)。若存在REVIEW.md也一并读——里面的意见是你工作的一部分。 - 读文档:按 HANDOFF 指定顺序读 spec(
.local/docs/design/spec/)→ plan(.local/docs/design/plan/)→ 项目根AGENTS.md/CLAUDE.md+ 项目索引(如有.local/docs/INDEX.md)。 - 采信事实表:HANDOFF 里的「已验证事实」是上一会话读源码考证过的,直接用,禁止重复考证;真要推翻,先回 channel 留言说明证据。
执行纪律
- 按 plan 阶段推进;阶段 0 冒烟验证先行,其断言是后续所有决策的地基。
- plan/spec 与代码现状冲突、或冒烟断言失败 → 停下来写进
IMPL-NOTES.md并告知用户,不要自由发挥绕过。 - 遇到 HANDOFF 列的「待决策点」:自行决策,决策与理由记入
IMPL-NOTES.md。 - 项目通用纪律全适用(以仓库根
AGENTS.md/CLAUDE.md约定为准,有踩坑记录先读)。 - 测试完毕后关闭过程中起的服务和进程(dev 实例、冒烟脚本、临时端口监听等)。
沟通协议(只认文件)
IMPL-NOTES.md:进度、卡点、决策,追加式、倒序(最新在最上)、每条带日期时间并标注所属阶段。DONE.md(完成时写):验收清单逐项打勾 + 改动文件清单 + 自测记录(手测每步的实际结果,不是「应该没问题」)。REVIEW.md:review 方的意见入口;每次复工前先读,逐条回应(改代码或在 IMPL-NOTES 说明不改的理由)。- 完成后提醒用户:DONE.md 已就绪,等 review。
收尾(DONE.md 之前必做)
- 项目自带的 lint / typecheck / test 全绿(按
package.jsonscripts 或项目等价命令),输出摘要贴进 DONE.md。 - 若项目维护了
.local/docs/INDEX.md之类的代码索引:把新增/删除/改名的代码文件、变化的导出与签名补进对应清单。spec/plan/channel 文档不要加进索引(索引只标目录不标文件,文档会不定期清理)。 - 若实施中发现 spec/plan 过时(决策被推翻、边界调整):在 channel 留言说明,不要顺手改 spec——spec 的修改权在发起会话/用户。