huxiang1126/huxiang-skills/huxiang-handoff

huxiang-handoff：对话交接器

一场对话快开到头了，脑子里装的东西比屏幕上打出来的多。这个 skill 干的事：在断片之前，把「值得记一辈子的」和「只是这一局要接着打的」分开装箱。

触发时机

• 用户明说：交接、写个 handoff、开新对话前、这对话要满了、context 快用完了
• 自己觉察到：对话轮次已经很多、跨了好几个话题/任务、系统提示即将自动压缩（compact）、或者用户表现出要收尾切换的意思——这时候主动提一句「要不要我先写个交接」，别等用户想起来才做，那时候往往已经晚了

执行

一、通读，别摘抄

把整场对话从头看一遍。不是复制粘贴消息，是回答这几个问题：

• 这场对话本来要解决什么？现在解决到哪一步？
• 做出过哪些不那么显然的决定？为什么这么定的（别人接手要是不知道理由，很可能会推翻重来）？
• 哪些路走不通，已经试过了？（不写下来，下一个我会原地重试一遍）
• 用户纠正过我什么？确认过我什么做对了？
• 卡住的地方是什么，卡在哪个具体环节？
• 下一步第一件具体要做的事是什么？不是「继续推进」，是「打开哪个文件，改哪一行，跑哪条命令」

二、分诊：记忆 vs 交接

同一件事只能进一个箱子，别两边都塞。

判断标准：这件事下次这个项目/这个人出现时还有用，还是只对「接上这盘没下完的棋」有用？

• 前者 → 写入长期记忆（如果 ~/.claude/projects/-Users-hx/memory/MEMORY.md 存在，就按它已有的 frontmatter 格式和 user/feedback/project/reference 四种类型走，写文件 + 在 MEMORY.md 加一行索引；不存在就跳过这步，在 handoff 里注明"未发现记忆系统"）
• 后者 → 只进 handoff.md：具体的现场状态、临时决定、还没测完的分支、这次对话专属的上下文

不确定归哪边，就问自己：三个月后这条信息还有意义吗？有 → 记忆；没有 → 交接。

不要把整场对话的流水账塞进任一个箱子。只留活的——下次真会用到的。

三、写 handoff.md

结构固定，按顺序：

# Handoff · {项目/主题} · {YYYY-MM-DD HH:MM}
 
## 一句话现状
{一句话：现在卡在哪，或者刚做完什么}
 
## 目标
{这场对话本来要干什么}
 
## 已完成
-{具体成果，能验证的那种，不是"讨论了"}
 
## 进行中 / 未完成
-{具体差什么，差多少}
 
## 关键决定
-{决定了什么} — 为什么：{理由，别人/别的我看到能不重新纠结}
 
## 走不通的路
-{试过但放弃的方案} — 为什么放弃
 
## 下一步第一件事
{具体到可以直接执行的一个动作：打开哪个文件/跑哪条命令/问用户哪个问题}
 
## 相关路径与链接
-{文件路径、仓库、URL}

规则：

• 空的章节直接删掉，别写"无"
• 「下一步第一件事」必须具体到能直接上手，不能是"继续跟进"这种空话
• 长度服从内容，短对话交接三五行足够，别硬凑结构

四、存哪

• 当前目录是个项目（有 .git，或明显是某个具体项目的工作目录）→ 写到项目根目录 HANDOFF.md，覆盖旧版本（git 历史已经留档，不用自己维护多版本）
• 当前目录不是具体项目（比如就在 ~ 下随便聊）→ 参考 denote 惯例，写到 ~/Documents/notes/{时间戳}--{关键词}__handoff.md，时间戳用 date +%Y%m%dT%H%M%S

如果项目根目录已有 CLAUDE.md 且它还没提到 handoff 机制，可以顺手建议用户加一行指向 HANDOFF.md，让下个对话自动读到——但这是建议，不要擅自改 CLAUDE.md。

五、收尾播报

写完之后，用两三句话告诉用户：

• 文件存在哪
• 长期记忆存了几条、分别是什么类型
• 下一个对话框打开后第一件事该干什么

不要把 handoff.md 全文再念一遍，用户自己会看文件。

边界

• 这个 skill 生成的是给「下一个我」看的交接文档，不是给用户看的工作汇报——语气可以直白、可以有缩写，不用照顾可读性以外的东西
• 不做记忆体系的整体审计（合并重复、清理过期记忆）——那是 consolidate-memory 的活，这里只负责这一场对话产生的增量
• 不擅自修改 hooks/settings.json 去做到"自动在压缩前触发"——那是配置变更，属于 update-config 的范畴，这个 skill 只负责被叫到时把活干好