交接

为什么需要这个工作流

交接的本质是信息压缩。下一个会话需要的不是对话全文，而是能安全继续的最小事实集。八项清单保证完整性，空的类别必须写"无"而不是悄悄消失——因为在下一个读者眼里，"漏写"和"确实没有"长得一模一样。

流程逐阶段拆解

下面每一条规则都取自源仓库里的工作流定义——这就是智能体真正被要求做的事。

1. 01

   收集当前事实

   重新读真实状态，而不是凭记忆写。

   • 重新读版本控制状态和相关 diff。
   • 读权威的需求和设计文档。
   • 查最新一次验证输出，而不是依赖记忆。
   • 找出阻塞、未决决定，以及必须保留的无关改动。
2. 02

   产出交接记录

   八项，逐项写明，空类别写"无"。

   • 目标与验收行为。
   • 当前实现状态。
   • 关键文件与权威文档。
   • 已经做出的决定及其原因。
   • 跑过的命令与最新结果。
   • 剩余任务，按依赖顺序排列。
   • 已知风险、阻塞和未验证区域。
   • 版本控制状态，以及需要保留的无关改动。
   • 引用只是支撑事实，不能替代事实：即使给了链接，也要简述每个决定和它的原因；文档、提交、diff 和测试输出用引用而不是整段复制。
   • 你给出了输出路径就写到那里；没有给路径就只在回复里返回，不静默创建仓库文件。

不可绕过的规则

一次真实调用

从你发出的 token 到你拿回的证据，这次对话实际长什么样。

1. 智能体

   重新读取 Git 状态和 diff、权威需求记录，以及最近一次测试输出。

2. 智能体

   把事实组织成八项，"阻塞"这一项写"无"，而不是直接省略掉。

3. 智能体

   逐条简述决定和它的原因，需求文档和测试结果用引用而不是粘贴全文。

4. 智能体

   把记录直接返回在回复里——因为没有给路径，所以没有创建任何文件。

什么时候用它

• 会话即将结束，工作要交给下一个会话或同事。
• 上下文窗口快满了，压缩之前需要把状态保存下来。
• 需要一份可执行的记录，说清任务到底停在哪里。
• 别人要接着做，不能让他重复你已经做过的决定。

什么时候改用别的

常见问题