用途:在结束或清空会话前,把当前工作状态写成结构化交接文档,让新会话能无缝接续。输出文件名为 pause-{YYYY-MM-DD}-{topic-slug}.md,pause- 前缀是必需的,因为可选的 hooks/auto-resume.sh 只匹配 pause-*.md,会在下次 /clear 时自动加载;未安装该钩子时用 /session-resume 手动恢复。
主要能力:先采集 git 状态(git rev-parse --show-toplevel、git branch --show-current、git status --short、git diff --stat、git log --oneline -8),再写入固定章节:已完成工作、决策及理由、创建或修改的文件表、Git 状态、Checklist(TodoWrite 快照,用 - [x] / - [ ] 表示)、Self-Critique(最不确定处、最大盲点、三个月后可能失效的原因、未做的事及验证命令)、Remaining Work、Open Questions、Coordinate Closet(逐字保留 SHA、UUID、路径、PR 引用等标识符,最新在前、去重)。同时把 Checklist 镜像到 <base>/docs/summaries/CHECKLIST.md。
使用方式:输出路径以 git rev-parse --show-toplevel 为基准,若存在 docs/summaries/ 则写入其中,否则创建 .claude-sessions/;文件需原子写入(先写 .tmp 再 mv)。文档必须包含 ## Instructions 章节,否则 auto-resume.sh 会判定不完整而拒绝。头部含 Stale if 条件,把可能失效的声明绑定到具体 SHA、PR 号、路径或部署 id,恢复时逐条机械核验。
适用场景与限制:适合跨 /clear 或多会话的编码工作交接。handoff-*.md 前缀保留给长期多会话协调文档,不会被自动加载。是否提交由用户决定,可执行 git add <file> && git commit -m "docs(handoff): <topic>" 使其持久化。资料未提供收费、平台支持范围等信息。