| name | phase-closeout |
| description | 中文阶段收尾。用于完成一个阶段、准备开新对话、需要更新状态快照时。由 workflow-system 或 drift-auditor 调用。 |
| allowed-tools | Bash, Read, Write, Edit, Glob, Grep |
阶段收尾
身份:收尾者。总结、冻结、更新快照。绝对禁止开发新功能。
遵守 references/BEHAVIOR_SPEC.md、references/STATE_MACHINE.md、references/EVIDENCE_CHAIN.md。
📦 Artifact 交接
| 输入 | 输出 |
|---|
| 本轮所有 Artifact(briefing / plan / patch / lesson / audit) | 汇总到真相源(PROJECT.md / TASK_QUEUE.md / DECISIONS.md / STATE_SNAPSHOT.md) |
只读 Artifact + 现有真相源。不重新读取代码或聊天历史。
📍 阶段位置
[●入口] → [●引导] → [●策划] → [●执行] → [●审计] → [◉收尾]
当前角色: 收尾者 | 上一站: 审计 | 下一站: 结束/新循环
当前阶段自动写入 STATE_SNAPSHOT.md 的 current_phase 字段。
启动自检
- 读取
BEHAVIOR_SPEC.md 第一章:确认收尾者边界
- 读取
STATE_MACHINE.md:确认当前状态
- 读取所有真相源文件
- 读取
CLAUDE.md 和 RESUME.md:确认恢复系统状态
- 先执行一次轻量漂移审计(有偏离先修再收尾)
硬边界(收尾者 == 冻结,不创新)
| 允许 | 禁止 |
|---|
| 总结已完成内容 | 开发新功能 |
| 汇总证据链到 DECISIONS.md | 引入新方案 |
| 冻结模块和接口 | 修改代码 |
| 生成新对话口令 | 隐藏未验证内容 |
| 标记未完成任务 | 跳过轻量审计 |
工作流程
1. 收尾前快速审计
对照 BEHAVIOR_SPEC.md §2:
2. 总结完成内容 + 验证结果
3. 列出未完成(待开始/进行中/阻塞)
4. 识别新增决策 → 写 DECISIONS.md
5. 冻结判断(接口/模块/命名)
6. 发布检查
对照 references/RELEASE_PIPELINE.md 逐条确认:
缺一条 = 没发布完。 全部通过后才进入第 7 步。
7. 更新真相源
STATE_SNAPSHOT.md:对照旧版本逐字段确认后再改,禁止凭空重写。特别是 active_tasks 列表——旧版本有的条目不能丢,只能增/改状态/删已完成。
TASK_QUEUE.md:移动已完成 → 设新任务
DECISIONS.md:汇总证据链 + 新决策
PROJECT.md:更新目标、阶段、冻结区域
RESUME.md:更新 status、completed、next_step,必须填写 context_snapshot
decisions: 本轮做了什么决策 + 为什么
eliminated: 排除了哪些方案 + 原因
user_style: 用户交流偏好(简短/详细、自主/跟从)
landmarks: 对话关键节点
footguns: 下个窗口最容易犯的错(明确列出不要做什么)
- context_snapshot 不可省略。 这是下一窗口 AI 恢复"记忆"的唯一来源。只填状态=新窗口 AI 不认识用户。
8. 生成新对话口令
这是新对话。请先读取:
- CLAUDE.md(会话启动指令 + 恢复检查)
- RESUME.md(任务恢复点 / 自动 checkpoint)
- PROJECT.md(目标/阶段/冻结)
- DECISIONS.md(所有历史决策 + 证据链汇总)
- TASK_QUEUE.md(任务队列)
- STATE_SNAPSHOT.md(当前状态快照)
以这些文件为准,总结当前状态,告诉我下一步唯一行动。
证据链汇总
本轮所有动作记录 → DECISIONS.md 附录。
偏离处理
收尾中发现新问题 → 不自己修 → 调 /drift-auditor。
交互预算自检
收尾输出前检查(BEHAVIOR_SPEC.md §7.3):
禁止事项
- 不开发新功能 / 不隐藏未验证内容
- 不把聊天历史当唯一来源 / 不跳过审计
- 详见
BEHAVIOR_SPEC.md 第六章