工作流
收尾协议
为什么每次工作结束都要收尾，以及收尾的四个阶段。
为什么需要收尾
AI 会话的特点是易中断——上下文会压缩、会话会结束、模型会换。如果工作到一半停下来，没把认知落盘，下一次开工时 AI 就不知道你做到哪了。
Spiry 的收尾协议就是为了解决这个问题：在每次交还控制权前，机械地完成认知落盘。
收尾四态
输入 /spiry-close 触发收尾。收尾分四个阶段，严格有序：
命令后还可以跟一段收尾附加指令（如 /spiry-close Commit+push＝授权收尾时本地 commit 后直接 push 到 upstream）；不跟则一切按缺省执行，push 前会停下来问你。全部命令形态见 命令手册。
① work-complete——工作完成确认
确认实质工作已完成。列出本次交付物和验证方式。
② governance-close——治理收口
认知落盘的核心步骤：
- 覆盖热屋——更新当前站位游标到最新状态
- 追加冷屋——记录本次关键决策的 WHY
- 一致性排查——检查热屋/冷屋/导航图是否一致
- todo list 同步——如果有 TodoWrite 任务列表，核对同步到真实完成状态
③ git-deliver——版本交付
将改动 commit 到本地 git。每次 commit 附带清晰的 commit message。
夜航模式下的 commit夜航模式下，带消息的简单本地 commit 自动放行（不需要每次弹确认）。但 push 到远端、amend、--no-verify 等操作始终需要人确认——夜航也不逾越。
④ handoff-ready——交付态校验
验证交付态：
- 本地 HEAD 可解析、非 detached
- 与 upstream 的关系（equal / ahead / behind / diverged）
- 工作区干净
什么时候该收尾
- 完成了一段独立的工作（一个功能、一个 bugfix、一次重构）
- 准备结束当前 AI 会话
- 即将触发上下文压缩
- 到夜航模式的语义边界
小步收尾不要攒一大堆改动才收尾。频繁小步收尾能让认知更精确、回滚更容易。每完成一个独立小任务就收尾一次，是最佳实践。
收尾与压缩的关系
在配速模式下，到达压缩点时 Spiry 先做铺路（把热屋游标/下一步/待办轻度落盘、不 commit），然后自动触发压缩，压缩后自动注入续跑消息——AI 凭热屋＋压缩摘要无缝续跑，全程无需人工干预。压缩点≠收口点：要做含 git 交付与冷屋留痕的完整收尾，仍由人在真正的大阶段边界敲 /spiry-close。