write-handoff

编写交接说明

为下一位执行者提供足够稳定的上下文，使其能完成一项范围明确的工作，而无需重新创建所属 Plan 或文档。

使用 workflow-language.md；进行审查工作时使用 review-language.md，并使用 handoff-template.md。

选择意图和生命周期

常见类型包括实施／续做、研究、重构／修复缺陷、审查、审查续做和审查修复。选择能描述下一项工作的最精简类型。

根据预期用途选择生命周期：

• Immediate：下一位执行者或近期续做；当前路径和易变状态可能有帮助。
• Durable：交给较晚接手或未知的执行者，或用于跨工具复用的工作；重点说明稳定行为、验收标准和范围边界。

除非预期生命周期明确要求 Durable，否则默认选择 Immediate。交接说明可以写在聊天中，也可以放在文件里；存为文件并不意味着它是 Durable。

编写交接说明

1. 仅根据本任务需要，阅读所属 Plan、文档、Review Ledger、当前差异或源文件。
2. 说明确切任务、当前状态、范围、约束、完成条件和验证方式。
3. 只链接下一位执行者实际需要的权威文件。不要复制整份 Plan 或文档，也不要生成替代 Plan。
4. 仅在实现细节不易查明且能显著减少返工时，才加入易变的说明。
5. 将相邻想法排除在范围之外，或列入所属 Plan 的后续事项。

只有用户要求创建文件，或获授权的工作流明确需要存储产物时，才创建文件。如果仓库已有既定的交接文件存放位置，就使用该位置；否则请先询问，或返回可直接复制的文本。

审查交接说明

• 对于续审／增量审查，保留已接受的发现、补丁说明、变更范围、已解决事项、Review Signal、未解决风险和预期的下一步范围。
• 对于明确要求的独立交叉验证，说明审查内容可能重叠，并避免引导审查者得出预期结论。
• 如果 fresh review 可能实质上指续审或独立交叉验证，应将这一选择与其他需要确认的问题一并询问，不要擅自决定。
• 如果先前的 Review Signal 为 Low，应说明再次审查的预期收益可能较低，但不要拒绝明确提出的审查请求。

更新所属产物

不要仅仅因为存在交接说明就添加记录。只有在已验证的任务状态、必需工作或后续事项发生变化时，才更新 Plan。只有当添加简短链接能避免交接文件遗失时，才在产物中加入该链接。

使用 handoff-template.md，省略未使用的部分，并确保内容独立完整且简明。