别让你的工作被 /clear 清掉——认识 session-handoff

如果你曾经完成一段漫长的调试，按下 /clear，然后在一周后又懊恼地想起自己已经忘了团队排除了三种数据库方案中的哪一种——这篇文章就是给你的。

问题很小，但代价不低。与 AI 代理一起处理真实项目时，会生成一层只存在于对话中的知识，别处都找不到。为什么某个库被否决了。哪个预发布环境坏了。用户说的“the gate”到底是什么意思。它不在代码里。它不在 git 里。它在对话里。而对话马上就要被抹掉了。

抢救测试

session-handoff 是一个小型 Agent Skill，会在你清空之前运行。它会扫描会话中的事实，并提出一个决定性的问题：

“重新读一遍仓库能找回这个信息吗？”

如果答案是肯定的，那就别保存——代码才是事实来源。如果不是，那它可能值得保存。这一个简单的启发式规则能大约消除 80% 的误保存，让长期记忆文件不会变成噪音。

它在实践中如何运作

整个流程有七步，但实际体验只有两步：输入像 “清空前做个检查点” 这样的触发语，查看会保存什么，确认。然后该技能会写入结构化的 markdown 条目——user 用于角色和环境，feedback 用于工作规则，project 用于目标和决定，reference 用于外部系统指针——并更新一个单行索引文件，让后续会话可以低成本加载。

有两个技术细节让它真正可用：

• 日期归一化。 “Thursday” 会在提取时转换为 2026-05-21，因此三个月后这条记录仍然说得通。
• Why / How 结构。 每条 feedback 或 project 记录都包含原因（通常是过去发生过的事件）以及规则适用的时机。这样未来的你就能判断边缘情况，而不是盲目照搬笔记。

谁需要它

如果你的工作涉及长期迁移、多方协作上线，或者任何书面约定会比产生它的对话活得更久的事情——那它就是你需要的东西。平台负责人、SRE、交接工作的合同工程师。不是因为它很聪明，而是因为没有它，你只能在三周后才手忙脚乱地重建那些你其实早就知道的信息。

仓库是开放的，而且这个技能小到可以一口气读完：

👉 github.com/andreab67/agent-skills/blob/main/session-handoff/SKILL.md