用途：handoff 用于把长任务的关键信息压缩成一份结构化 Markdown 交接文档，供上下文为空的智能体直接续接工作，避免重读整段对话。
触发方式：一是手动，用户明确要求交接、保存状态或给出下一步计划时写文件；二是自动检查点，当宿主请求上下文交接时写文件，并追加自动继续说明。单纯的编辑次数增加不构成打断已授权工作的理由。
流程：按 gather（收集）→ structure（组织）→ write（写入）→ verify（验证）→ resume（续接）执行，完整细节见 ref/pipeline.md。写前预检需先确认已知目标和下一动作，若两者都没有，应说明“暂无可交接内容”，不得编造进展。收集须机械地从工具历史推导读取与修改集合，原样记录命令、测试输出和错误文本，并以只读方式确认 git 分支、HEAD 与工作区状态，不依赖回忆。必须原样保留未回答的用户问题到 Open Questions，若该问题阻碍下一步则同时写入 Current State。
文档结构：按 ref/templates/handoff.md 填写，功能开发用 -coding.md，问题排查用 -debugging.md；顺序为 Current State 在前，Done 标注“DO NOT REDO”并量化，只写一个下一步，记录带理由的决策，以及具体 file:line、命令和真实错误。
验证与写入：写前运行 ref/checklists/quality.md，修正密钥、占位符、含糊表述、缺失验证命令或遗漏的未答问题。文件保存为工作项目下 handoffs/handoff-<UTC>.md（ISO 8601，冒号与斜杠替换为连字符，如 handoff-2026-05-30T12-00-00-000Z.md）；若已存在先前交接文件则链接并合并。
输出：打印路径与一行摘要，再将文档包在 <handoff-context>…</handoff-context> 中作为可直接粘贴的续接块。自动触发时追加自动继续说明，遵循用户最新意图，若无剩余事项应明确说明。
参考与限制：ref/ 下有完整流程、模板、质量与续接清单；examples/ 中有示例；scripts/check-staleness.sh 可在信任前校验交接文件。硬性规则包括记录精确技术状态而非抽象描述、绝不包含密钥或令牌、产物本身即全部工作并把对话内问题转入 Open Questions 而非直接回答，文件为唯一事实来源，<handoff-context> 块仅作传输载体。资料未提供具体收费、平台或价格信息。