会话交接文档

要解决的具体问题

跨会话接续是 AI Agent 工作流里最常见的断裂点。一次重构谈到第 40 轮，模型窗口被压满、上下文里夹杂大量探索性试错；此时换模型、换人，或干脆开启一个全新会话，接手者要么把前 40 轮重读一遍，要么凭残缺记忆猜进度。结果就是重复劳动、遗漏决策理由，或者在已排除的方向上又踩一遍坑。

@kunlungrowth/kg-handoff 不做别的事，它只负责把当前对话压缩成一份精炼、脱敏、自解释的交接文档，让下一会话读到即可上手。

核心能力与关键步骤

这个技能的工作流分五步：

1. 收集上下文：通读当前对话，提取目标、已完成步骤、当前卡点、关键决策、未决问题，以及重要文件路径与命令。
2. 去重引用：不复制已有工件（spec、plan、ADR、issue、commit、diff）里的内容，改用 path 或 url 引用，避免文档膨胀成第二份代码仓库。
3. 写交接文档：按 references/template.md 组织，必含"建议后续技能"小节——列出下一会话应调用的技能，如 mp-grilling（解决 open_questions）、mp-teach（补知识盲区）。
4. 脱敏：删除 API key、密码、PII 后才落盘，并在文档中标注 redacted: true。
5. 落盘到临时目录：写入 $TMPDIR 或 /tmp，不要写入当前工作区。若用户传入"下一会话用途"参数，按其描述裁剪文档重点。

最终产出是一个结构化工件 HandoffDoc：goal、done、blocked、decisions、open_questions、artifacts、suggested_skills、redacted、saved_path，外加落盘路径和一句话摘要。

适用边界与注意点

• 适用：用户说"写个交接""handoff""把进度交接给下一轮"；长任务要中断、换模型或换人接续（分阶段编码、跨会话研究）。
• 不适用：文档必须存临时目录，存进工作区会污染仓库；敏感信息必须先脱敏再落盘，没有例外；本技能不执行后续工作，它只负责交接，接力棒交出去就结束。
• 如果下一会话的用途很明确（比如"主要做测试"），传入参数能让文档重点更聚焦，而不是面面俱到。