会话交接：在会话结束时把已完成、待办与经验写入…

用于跨会话保持连续性：结束会话时记录完成/待办/经验，开始会话时加载并给出恢复摘要。

适用场景

解决思路

1. 会话结束时，先从 git status/diff 和对话中回顾本次会话：涉及的文件、已完成与未完成的任务、做出的决策及原因、观察到的用户纠正。
2. 检查是否存在未提交的改动；若有，在收尾前主动提出先提交。
3. 将 handoff 写入 `.claude/handoff.md`，使用规定格式；单文件、始终覆盖，只保留当前状态。若已有 handoff 含他人的待办任务，覆盖前先询问：合并、覆盖还是跳过。
4. 提取经验：值得保留的纠正与发现通过 `instinct-system` 写入 `MEMORY.md`；新出现的模式通过 `instinct-system` 更新 `.claude/instincts.md`。handoff 的 Learned 部分只是触发点而非最终归宿——handoff 是临时的。
5. 向用户确认：总结已捕获的 handoff 与经验。
6. handoff 文件格式（`.claude/handoff.md`）：写给零上下文的陌生人——包含文件路径、理由、具体下一步。不要写“继续重构”，要写“将 `src/Orders/CreateOrder.cs` 重构为 Result 模式——参考 Catalog 中已确立的模式”。
7. handoff 模板结构：标题 `# Session Handoff`，引用行 `> Generated: 日期 | Branch: 分支名`，然后依次为 `## Completed`（用 `- [x]` 列出，附文件路径与行号）、`## Pending`（用 `- [ ]` 列出，附参考文件）、`## Learned`、`## Context`（分支、最后一次提交、是否有未提交改动、解决方案文件）。
8. 当多名开发者共享项目时，额外添加 `## Decisions Made` 表格（Decision | Choice | Rationale）和 `## Open Questions`。
9. 经验提取检查清单：1) 用户是否纠正过什么？→ 通过 `instinct-system` 写入 MEMORY.md；2) 是否发现非显而易见的事？→ 写入 Learned 部分；3) 是否带理由地做了决策？→ 记录“为什么”；4) 某个工具/方法是否失败？→ 记下来，避免下次会话重试。
10. 经验要具体：好例子“EF compiled queries don't work with Include()”；坏例子“Worked on Orders module”（含糊）或“Used TimeProvider”（已是规则）。
11. 会话开始时加载上下文：读取 `.claude/handoff.md`（待办工作）、`MEMORY.md`（永久规则）、`.claude/instincts.md`（置信度 0.7+ 的模式）。文件缺失没关系：注明后干净开始——绝不因缺失而阻塞。
12. 检测解决方案文件：在当前目录、再向父目录、再向子目录查找 `.slnx`/`.sln`，以便 Roslyn MCP 工具从第一条提示起就可用。
13. 给出恢复摘要：上次会话的工作、待办任务、生效的规则/instincts 数量、检测到的解决方案。然后询问要做什么——绝不自动开始待办工作。
14. 会话中途只想保存而不结束会话时，改用 `/checkpoint`。

适用边界 · 注意事项

• 会话中途只想保存进度而不结束会话时（应使用 `/checkpoint`）。
• 缺少 handoff、MEMORY 或 instincts 文件时不要阻塞会话开始，注明后干净开始即可。
• 已有 handoff 含他人待办任务时不要直接覆盖，需先询问合并、覆盖还是跳过。