用途：session-continuation 用于在多次 AI 编码会话之间保存与恢复工作流状态，典型流程是先做 handoff（交接），再用 resume（续接）继续同一任务。
主要能力：
- 触发机制：当 token 占用达到或超过 75% 时，建议执行 handoff；用户说 handoff 或 save 时执行保存；用户说 resume 并给出名称或 ID 时加载。
- 交接文件：每个会话一个文件，存放在 .claude/handoffs/<name>.{json,md}。名称取会话标题的 slug：/rename 自定义标题 → 自动（AI）标题 → session-<id8>。同一项目内两个会话不会互相覆盖；同名冲突时追加 -<id8>。
- 交接流程：运行 node "${CLAUDE_PLUGIN_ROOT}/hooks/compact-handoff.cjs" --save --note "<完成 · 下一步 · 决策 · 阻塞>"。会话 ID 来自 SessionStart 导出的 AF_CLAUDE_SESSION_ID。note 需由使用者具体填写。交接会记录计划树锚点（.claude/plans/active.json）以及项目自身的计划文档（ROADMAP.md、*_PLAN.md、docs/plan 等），若其中某份是活动计划，应在原处更新，不要另建第二份计划。
- 代码项目中若存在打开的 /run，还需维护 run-state.json（current_phase、next_action）。非代码项目（无 .git、无 manifest）不创建 .claude/logs/runs/ 或计划日志，交接文件是唯一状态。
- 续接流程（/run resume <name>）：运行 node "${CLAUDE_PLUGIN_ROOT}/hooks/compact-handoff.cjs" --show <name>（接受名称、标题或会话 ID；--list 列出全部）；重新读取其列出的计划文档与运行状态，核对文件状态，然后从 note 或下一步继续，不重启已完成的工作。
- 自动保存与自动恢复：hooks/compact-handoff.cjs 会自动保存同一会话文件。PreCompact（手动与自动）始终保存；Stop 时若上下文占用 ≥ AF_HANDOFF_THRESHOLD（默认 70%，读取自 statusline 的 .claude/cache/context-usage.json）则保存，无 statusline 数据时仅在存在打开的 run 时保存。同一会话的 SessionStart（compact 或 resume）会注入其交接内容（自动快照随后删除，手动保留）；新会话只能获得命名交接的列表，不会获得其他会话的上下文；clear 不注入。超过 14 天的交接会被清理。可通过 AF_COMPACT_HANDOFF_DISABLED=true 禁用。
- TOON 状态格式：约 160 token，JSON 约 600 token。示例：workflow: id: AUTH-1234 / phase: 3 / status: in_progress / agents[2]: architect,tester。
- 错误处理：未找到时显示可用项并建议 /run；文件损坏时从 .backup.json 恢复。
- 清理策略：已完成保留 30 天，已取消保留 7 天，已暂停无限期保留。
使用方式：在支持 Claude 插件钩子的环境中使用上述命令；通过用户指令 handoff 或 resume 触发，或依赖钩子自动完成。
适用场景：跨多次会话延续的较大型编码任务、需要在上下文压缩前后保留工作状态的场景，以及希望减少状态传输 token 开销的项目。
限制：依赖 Claude 插件钩子与 ${CLAUDE_PLUGIN_ROOT} 环境；自动 Stop 保存依赖 statusline 数据或打开的 run；交接内容的具体性取决于用户填写的 note；非代码项目不产生运行状态或计划日志。