用途:在 /clear 或 /compact 之前、上下文即将耗尽(钩子可能在 80% 时自动触发)、工作会话结束或临时切换任务时,创建结构化交接文档以保留上下文,便于后续无缝恢复。
主要能力:生成交接文档,写入 thoughts/shared/handoffs/YYYY-MM-DD-{slug}-handoff.md,包含快速摘要、已完成事项(含 commit)、进行中任务、未开始任务、活跃文件、关键决策、重要发现、阻塞与开放问题、Beads 状态、学习与建议更新、按优先级排列的下一步。若存在 .beads/ 目录,运行 bd sync 并记录进行中与就绪任务。
使用方式:按流程捕获已完成任务及 commit、进行中工作的停止位置、关键决策与发现、阻塞项,写出优先级明确的下一步;分析会话学习点;如有 beads 则执行 bd sync;提交交接文档,提交信息为 docs: create handoff for [feature];随后审查学习点并提出经验保存建议。恢复时使用 /restore @thoughts/shared/handoffs/YYYY-MM-DD-{slug}-handoff.md。
反馈循环:扫描会话中出现 2 次及以上的学习点作为候选经验,向用户展示提案;用户批准后写入 docs/instructions/learned/{date}-{topic}.md 并提交;无重复学习点则静默跳过。不要自动编辑 CLAUDE.md 或指令文件,仅在用户明确批准时写入 docs/instructions/learned/。
最佳实践:尽早创建,不要等上下文耗尽;描述具体(如 login.ts 第 45 行);包含推理原因;立即提交。
限制:资料未提供收费、价格、平台支持范围等具体信息。