agent-session-resume

Agent 会话恢复

目的

在保持上下文连续的前提下，恢复或审查之前的编码 Agent 工作。先重建此前发生的情况，再继续从实际停止点着手。

核心工作流

1. 运行来源自检。

   • 如果可用，运行 python3 skills/agent-session-resume/scripts/skill-provenance.py。
   • 否则，将已加载的 SKILL.md 路径和大小与 $HOME/.claude 和 ${CODEX_HOME:-$HOME/.codex} 下已知的安装路径进行比较。
   • 在恢复报告的 Loaded skill 行中报告是否过时。详情见：references/evidence-and-provenance.md。

2. 确定来源。如果用户指定了平台，则读取 references/ 中对应的文件；如果请求涉及多个平台，则读取 references/cross-platform.md。否则，检查工作区中的会话文件夹、导出文件、摘要和工件。如果提供了会话标题，优先匹配完全一致或模糊匹配的标题，而不是依据最近时间选择。

3. 定位转录记录或最佳替代材料。优先选择完整转录记录而非摘要、工作区本地会话数据而非全局历史记录，以及用户明确提供的路径而非发现的路径。

4. 行动前先阅读所有可用的会话记录。对于大型转录，先盘点文件、事件类型和时间戳，再阅读包含证据的片段，直到完整梳理记录。完整覆盖意味着没有跳过相关证据；对于超大型记录，可以使用有限范围的搜索和片段，但须说明这一点并注明文件或事件。在完成此步骤前，不要编辑文件或重复之前的工作。

5. 在报告中记录已加载技能的来源信息：路径和来源／版本标记，或 unknown，绝不可猜测。详情见：references/evidence-and-provenance.md。

6. 重建上下文。总结目标、决策、约束和偏好；指出已完成的工作、已修改的文件、运行过的命令和测试；明确指出精确的停止点。每项工作状态声明都必须附带证据引用（src/file.ts:L20-L35、转录行号、命令输出，或明确标注“尚未检查”）。之前的恢复报告、摘要和交接内容都只是声明，不是原始证据：须通过转录记录、文件、Git 状态或命令输出重新核实，否则标记为未经验证。保留明确的用户暂缓事项（“跳过”“搁置”“现在不做”“暂停”），并注明证据、范围和重新处理的条件。

7. 提取任务。记录明确的待办事项、计划和未决问题；根据失败的测试、未完成的编辑以及“下一步”之类的表述推断隐含任务。具体记录尚未完成的任务。单独跟踪暂缓事项，不要归入 NOT DONE。分类如下：DONE（已完成且经过验证，或已不再需要）、PARTIALLY DONE（已开始，但缺少实现、测试、审查、提交、推送或确认）、NOT DONE（尚未开始或仅讨论过）。

8. 根据工作区验证。编辑前检查 Git 状态，并在检查点中说明；阅读之前会话修改过的文件。在存在未提交改动的工作树中保留无关的用户改动；如有工作冲突，请使用独立工作树或先征求同意。如果转录记录与当前文件存在冲突，以当前文件为准并报告不一致之处。

9. 从第一个未完成步骤继续。不要重复已完成的工作；除非既定方法明显有问题，否则应沿用已确立的方法和风格。只有在信息缺失或选择不安全导致受阻时，才询问用户。

恢复模式

根据用户的提示，决定完成检查点后要进行到哪一步：

• Report-only：用户询问发生了什么、哪些已完成和待处理，或要检查／审计／审查之前的会话，且不涉及编辑。完成恢复报告并明确说明下一步后停止。
• Continue-edit：用户要求继续、修复、实现、创建 PR 或运行测试。先报告，再从第一个安全的未完成步骤继续。
• Quick resume：状态报告或任务分解。优先提供简洁的来源清单、任务分类和下一步行动。
• Deep resume：继续实施、来源不明确，或文件可能已发生变化。完整阅读记录和当前 Git 状态，然后继续。

平台参考资料

• Claude Code：references/claude-code.md
• Codex：references/codex.md
• Cursor：references/cursor.md
• Antigravity：references/antigravity.md
• OpenCode：references/opencode.md
• GitHub Copilot：references/github-copilot.md
• 跨平台 / 多 Agent 请求：references/cross-platform.md

必需的响应格式

继续执行前，先报告：

## Brief context summary

- Goal: <prior session goal>
- Loaded skill: path=<loaded SKILL.md path or "unknown">; source/version=<version marker or "unknown">
- Source reviewed: <transcript/export/artifact refs>
- Current workspace check: <git status summary and touched-file refs, or why not checked>
- Transcript/current repo mismatches: <none found | claim, transcript ref, current-repo ref, action>
- User deferrals: <none found | deferred scope, user wording, evidence ref, reopen condition>
- Stopping point: <last command, edit, failure, or user pause instruction with evidence>

## Task status breakdown

- DONE: <task> - evidence: <implementation refs>; verification: <test/tool refs or "not recorded">.
- PARTIALLY DONE: <task> - evidence: <started-work refs>; missing: <remaining gap refs>.
- NOT DONE: <task> - evidence: <TODO, failing test, absent artifact, or transcript gap refs>.

## Clear next action

- Next: <first unfinished step to take now>
- Blocked: <no | yes - reason and evidence>

然后立即继续，除非遇到阻碍。证据规则和静态幂等性约定：references/evidence-and-provenance.md。

防护规则

• 用户提供了标题或路径时，绝不假设最新文件就是正确的记录稿。
• 绝不只根据文件名进行总结，也绝不将简短摘要视为可用的完整记录稿。
• 除非用户明确要求，否则绝不重置、还原或丢弃现有更改。
• 绝不只根据计划将任务标记为 DONE 或 PARTIALLY DONE；状态必须有已完成或已开始工作的证据。
• 记录稿与已检查的文件不一致时，绝不遗漏这种不匹配情况。
• 绝不根据含糊的“继续”或“接着做”重新启动已暂缓的工作；应确认用户是否希望重新开启这部分工作。