用途:为 AI 智能体会话迁移生成完整交接文档,使新智能体能无缝继续先前工作,缓解长时间运行智能体上下文耗尽问题。触发时机包括用户请求交接/记忆/上下文保存、上下文将满,或在大量改动、复杂调试、重大决策后主动建议创建交接。
主要能力:分 CREATE 与 RESUME 两条流程。CREATE 先用 python scripts/create_handoff.py [task-slug] 生成预填文档(含时间戳、项目路径、git 分支、近期提交、改动文件),续接时加 --continues-from 链接前一份;随后补全 [TODO: ...] 段落,重点包括当前状态、重要上下文、即时后续步骤、已做决策及理由;再用 python scripts/validate_handoff.py <handoff-file> 校验完整性、必需段落、潜在密钥(API key、密码、令牌)、引用文件是否存在及质量评分(0-100),检测到密钥或评分低于 70 不应定稿。RESUME 流程先用 python scripts/list_handoffs.py 列出可用交接,再用 python scripts/check_staleness.py <handoff-file> 检查新鲜度(FRESH、SLIGHTLY_STALE、STALE、VERY_STALE,依据时间、提交、改动文件、分支分叉、缺失引用文件),然后完整阅读文档,按 references/resume-checklist.md 验证上下文,从“即时后续步骤”第 1 项开始,并随进度更新待办与发现。
存储与命名:交接存于 .claude/handoffs/,文件名为 YYYY-MM-DD-HHMMSS-[slug].md。支持链式交接:后续文档通过 --continues-from 链接前一份,可标记旧文档被取代,新智能体先读最新一份再按需回溯。脚本包括 create_handoff.py、list_handoffs.py、validate_handoff.py、check_staleness.py;参考文件包括 handoff-template.md 与 resume-checklist.md。
限制:官方资料未提供安装命令、支持的平台或收费信息,这些事实暂未提供。