菜单
保存当前工作的会话交接上下文（session handoff）。当用户说'保存上下文'、'先记一下'、'帮我做个 handoff'、'准备切会话'、'compact 前存一下'、'sh-save'时触发。适用于把当前进展整理成可恢复的短期 handoff。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | sh-save |
| description | 保存当前工作的会话交接上下文（session handoff）。当用户说'保存上下文'、'先记一下'、'帮我做个 handoff'、'准备切会话'、'compact 前存一下'、'sh-save'时触发。适用于把当前进展整理成可恢复的短期 handoff。 |
把“这次会话做到哪了，下一次应该怎么接上”整理成一份短期交接文件，写入本地 memory/session-handoffs/。
这不是项目知识沉淀，也不是完整对话归档。
sh-save 负责短期 handoffsh-load 负责恢复 handoffkb-distill 负责把长期有效经验沉淀到 knowledge/projects/ 或 knowledge/resources/先用仓库脚本落盘，再基于结果做必要说明：
python3 scripts/session_handoff_save.py --topic "gateway migration" --current-goal "..." --done "..." --decision "..." --risk "..." --next-step "..."
如果用户明确给了 scope，优先使用：
python3 scripts/session_handoff_save.py --scope opensource-gateway-phase2 --current-goal "..." --next-step "..."
只有在脚本无法覆盖当前场景时，才手动编辑 handoff 文件。
如果本次保存表示“切换到这个事项继续干”，显式带上 --set-current yes。
如果只是后台记录、验收、测试或不想抢占默认 sh-load 入口，带 --set-current no。
按 scope 存储：
memory/session-handoffs/
└── <scope>/
├── latest.md
├── meta.json
└── history/
└── YYYY-MM-DD-HHMM-<slug>.md
同时维护全局活跃事项索引：
memory/session-handoffs/_active.json
memory/session-handoffs/ 是本地短期状态，默认不提交到 Git。
优先级从高到低：
--scope--topic，自动生成 ad-hoc_<topic-slug>--req-id--scope 会归一化成英文 slug；--topic 可以包含中文，无法转成英文 slug 时会自动追加短 hash，避免不同中文主题写进同一个 scope。
推荐格式：
opensource-gateway-phase2ad-hoc_session-handoff-skills生成一份“最新稳定态” handoff，而不是流水账。
latest.md 只保留：
全文控制在 250-400 字；如果超过，主动压缩。
# Session Handoff
> scope: <scope>
> updated_at: <YYYY-MM-DD HH:MM local>
> status: active
> source: sh-save
> supersedes: <snapshot-id or none>
## Current Goal
<一句话说明当前正在推进什么>
## Done
- <已完成的关键进展>
## Decisions
- <当前仍影响后续判断的决策>
## Risks
- <当前主要卡点、风险、待确认项>
## Next
- <下次恢复时优先执行的 1-3 步>
## Related Files
- `<path>`
## Expire When
- <什么条件下这份 handoff 失效>
空节不要保留。
以下内容不应只停留在 handoff：
出现这些内容时，优先用 kb-distill 写入：
knowledge/projects/<project-name>/knowledge/resources/<scope>/不要在 sh-save 里定义第二套长期知识格式。
不要：
knowledge/简要说明：
latest.md示例：
已保存 handoff 到 `memory/session-handoffs/opensource-gateway-phase2/`。
- 更新了 `latest.md`
- 新增 history 快照：`2026-04-24-2215-design-updated.md`
- 未同步长期层
经验提炼。将会话中的调研结论、实测经验、踩坑记录、决策备忘沉淀到 knowledge/projects/ 或 knowledge/resources/。当用户说'沉淀'、'记录下来'、'存下来'、'总结会话'、'distill'、'kb-distill'时触发。
知识库进化与代码自省。审计 memory/long 一致性、沉淀 scratch 到长期记忆、清理过期 todo、扫描代码 TODO/FIXME、分析 daemon 错误根因、发现外部 skills/MCP 工具。当用户提到知识进化、memory 审计、代码自省、知识整理、认知迭代、能力发现时触发此 skill。
加载当前工作的会话交接上下文（session handoff）。当用户说'加载上下文'、'恢复一下上次进度'、'我刚开新会话，接着做'、'帮我看下上次做到哪了'、'sh-load'时触发。适用于从本地 handoff 恢复可执行工作简报。
Send formatted messages to Feishu webhook for alerts, batched updates, and daily briefs.
通用复盘与根因分析。适用于任何场景（开发需求、个人生活、兴趣爱好、项目管理），从问题出发，归类分析，找到根本原因，产出可执行的改进方案。当用户提到复盘、反思、总结经验、分析问题、找根因、回顾、改进、文档整理、目录重组时触发此 skill。即使用户只是说'最近状态不对'、'这次搞砸了'、'总结一下这个项目'、'文档太乱了'也应触发。