附录 J：Claude Code 交接模板

本附录把 Claude Code 会话中的局部工作转换为仓库可审查交接。恢复会话、读取 CLAUDE.md、使用自动记忆、工作树或子代理，都不能替代当前项目状态、输入快照和新鲜验证。

什么时候使用

在以下情形中填写本模板：

• Claude Code 会话被暂停、恢复或转交给另一位执行者；
• 工作从 Claude Code 转给 Codex、人工编辑或其他工具；
• 子代理、并行会话或工作树产生了局部工件，需要主会话或集成者接收；
• 会话记忆与仓库状态不一致，必须保留冲突而不是选择最近叙述；
• 局部审查已经结束，但共享文件、全仓 Validation 或外部动作仍待处理。

模板保存的是可回放证据，不是完整聊天导出。不要复制隐藏指令、密钥、私密会话或与任务无关的自动记忆。

Claude Code 接手前的读取顺序

本仓库中的 Claude Code 接手者按以下顺序恢复项目：

1. 读取 Claude Code 入口 CLAUDE.md，只把它当作通往共享规则的适配入口。
2. 按入口读取 AI_BOOTSTRAP.md 与 BOOK_RULES.md，把它们作为本仓共享项目契约入口，确认共同目标、完成定义和禁止动作。
3. 读取 PROJECT_CONTEXT.md、CURRENT_STATE.md、NEXT_TASK.md 与进度表，比较当前项目事实。
4. 读取相关决定记录与当前交接，确认未解决冲突和唯一集成责任。
5. 读取当前任务材料，并记录正文、来源、代码、测试或计划所对应的输入版本。
6. 单独记录会话是新建、继续还是恢复；检查自动记忆、工作树、子代理、工具和权限是否与当前任务相关且仍新鲜。
7. 对当前输入重新执行任务验收。会话恢复不使历史命令结果自动变新。

仓库状态与会话叙述冲突时，不按“更晚的消息”裁决。记录双方主张、证据路径、影响和具名决定责任者，并冻结受影响写入。

Claude Code 工具差异检查

检查项	应记录什么	不能推出什么
指令入口	实际读取的 CLAUDE.md、导入链和作用范围	上下文入口不等于权限或强制配置
会话状态	new、continued、resumed 或 unknown，以及对应输入	会话恢复不等于项目状态新鲜
自动记忆	是否读取、哪些内容与任务有关、怎样回到仓库证据	记忆不等于共享事实源或跨产品同步
工作树	实际路径、分支/输入身份和专属写入面	工作树隔离不等于账户、浏览器或数据库隔离
子代理	是否为当前任务使用、上下文来源、局部输出和限制	子代理返回摘要不等于集成完成
工具与权限	当前会话已验证的文件、命令、网络和批准边界	旧会话或其他工具的能力不能直接继承

可复制模板

复制下面内容到任务专属交接文件。共享字段与 Codex 模板保持兼容；Claude Code 特有状态只写入适配小节，不覆盖项目共同事实。需要刷新本仓当前交接时，由唯一集成者按 handoff prompt 把已核验内容更新到 .context/HANDOFF.md；会话或任务交接文件不是共享状态的自动替代品。

# Claude Code Handoff：<任务短名>

## 交接元数据

- `handoff_id`: `<稳定标识>`
- `status`: `<draft | delivered | blocked | superseded>`
- `created_at`: `<ISO 8601 时间或项目约定日期>`
- `owner`: `<本轮局部责任者>`
- `source_tool`: `Claude Code <已核验运行表面；未知则写 unknown>`
- `target_tool`: `<Claude Code | Codex | human | other | unknown>`
- `task_ref`: `<任务契约、Issue 或计划路径>`
- `input_snapshot`: `<输入版本、摘要、提交标识或文件清单>`
- `adapter_profile_version`: `<本次工具适配档案版本>`

## 目标与边界

- **目标：** <本次只完成什么可验收结果>
- **非目标：** <明确不做什么>
- **允许修改：** `<专属路径或文件>`
- **禁止修改：** `<共享文件、外部目标或其他边界>`
- **停止条件：** <出现什么情况必须停止并升级>

## 已读取基线

| 顺序 | 路径或来源 | 读取状态 | 版本／日期 | 对本任务的作用 |
| --- | --- | --- | --- | --- |
| 1 | `<CLAUDE.md 与实际导入入口>` | `<read \| missing \| conflict>` | `<值>` | `<适配范围>` |
| 2 | `<共享契约与规则>` | `<状态>` | `<值>` | `<目标、范围、DoD>` |
| 3 | `<Current State / Next Task / Progress>` | `<状态>` | `<值>` | `<当前阶段>` |
| 4 | `<决定与上一交接>` | `<状态>` | `<值>` | `<仍有效决定>` |
| 5 | `<任务材料>` | `<状态>` | `<值>` | `<输入范围>` |

## Claude Code 会话与适配档案

- `session_state`: `<new | continued | resumed | unknown>`
- `session_reference`: `<可披露定位；没有则写 none>`
- `memory_used`: `<none | 已读取但仅作线索 | unknown>`
- `worktree`: `<路径与输入身份 | not_used | unknown>`
- `subagents`: `<局部任务、返回工件与限制 | not_used | unknown>`
- `configuration_sources`: `<本次实际检查的来源；未检查写 unknown>`
- `adapter_reviewed_at`: `<复核日期或时间>`
- `official_evidence`: `<当前官方资料、访问日期与允许用途；未检查写 unknown>`
- `command_mappings`: `<项目验收命令在当前环境的实际入口；未执行不写 passed>`

| 能力 | 本次 Claude Code 状态 | 当前证据 | 目标工具状态 | 任务影响／替代路径 |
| --- | --- | --- | --- | --- |
| 文件读取／写入 | `<available_and_verified \| unavailable \| unknown \| requires_authorization \| alternative_required>` | `<实际观察>` | `<独立填写>` | `<影响>` |
| 命令执行 | `<状态>` | `<实际观察>` | `<独立填写>` | `<影响>` |
| 网络／浏览器 | `<状态>` | `<实际观察>` | `<独立填写>` | `<影响>` |
| 子代理／工作树 | `<状态>` | `<实际观察>` | `<独立填写>` | `<影响>` |
| 外部系统 | `<状态>` | `<实际观察>` | `<独立填写>` | `<影响>` |

## 当前状态

- **开始时：** <开始前可观察状态>
- **现在：** <当前可观察状态>
- **已完成：** <只列有工件或运行证据的事项>
- **部分完成：** <完成了哪一部分，还缺什么>
- **未开始：** <不得被下一位误认为已完成的事项>
- **状态冲突：** <没有则写 none；有则列证据路径和决定责任者>

## 交付物

| 路径 | 职责 | 状态 | 输入基线 | 集成注意事项 |
| --- | --- | --- | --- | --- |
| `<path>` | `<文件负责什么>` | `<created \| changed \| reviewed \| blocked>` | `<版本>` | `<共享影响>` |

## 实际证据

| 命令或检查 | 时间 | 退出状态 | 关键结果 | 只支持的有限结论 |
| --- | --- | --- | --- | --- |
| `<完整命令>` | `<时间>` | `<0 / 非 0 / not_run>` | `<计数或错误>` | `<覆盖哪些文件和行为>` |

## 风险、未知项与未运行范围

| 项目 | 当前证据 | 影响 | 临时动作 | 决定责任者 |
| --- | --- | --- | --- | --- |
| `<风险或 unknown>` | `<路径、输出或 none>` | `<阻塞什么>` | `<停止、补证或受限继续>` | `<owner>` |

- **未运行：** <全仓检查、真实产品、外部系统或其他未执行动作>
- **不能声称：** <局部证据明确不能支持的结论>

## 请求的共享写入

| 共享工件 | 请求变更 | 支持证据 | 集成者 |
| --- | --- | --- | --- |
| `<path>` | `<最小更新>` | `<本交接中的证据>` | `<唯一责任者>` |

局部责任者没有修改上述共享工件；若已经修改，说明授权、原因和验证。

## 共享状态同步

| 共享工件 | 状态 | 当前证据或请求 | 更新责任者 |
| --- | --- | --- | --- |
| `.context/CURRENT_STATE.md` | `<updated \| unchanged \| requested \| not_applicable \| unknown>` | `<路径或说明>` | `<owner>` |
| `.context/NEXT_TASK.md` | `<状态>` | `<路径或说明>` | `<owner>` |
| `.ai/progress.md` | `<状态>` | `<路径或说明>` | `<owner>` |
| `.ai/references.md` | `<状态>` | `<路径或说明>` | `<owner>` |
| `.context/DECISIONS.md` | `<状态>` | `<路径或说明>` | `<owner>` |
| `.context/HANDOFF.md` | `<状态>` | `<路径或说明>` | `<owner>` |

`updated` 必须有本轮授权和文件证据；局部责任者未获共享写入授权时使用 `requested`，并在“请求的共享写入”中交给唯一集成者。

## 唯一下一步

- **下一任务：** <一个可独立验收的动作>
- **下一 owner：** <具名角色；未知则写 needs_assignment>
- **先读：** <最小文件清单>
- **输入：** <必须使用的快照或版本>
- **允许输出：** <专属路径>
- **验收：** <可执行检查和成功标准>
- **停止条件：** <冲突、漂移、能力或批准缺口>
- **开始前 Gate：** `<needs_context | capability_review_required | state_conflict | integration_required | validation_required | ready_to_resume | human_decision_required>`

## 交接自检

- [ ] 已区分会话恢复、项目恢复和任务执行。
- [ ] 自动记忆只作线索，关键状态能回到仓库工件。
- [ ] 工作树、子代理、工具和权限均按本次环境独立核验。
- [ ] 每项“完成”都有文件或新鲜命令证据。
- [ ] 已记录风险、未知项、未运行范围和不能声称的结论。
- [ ] 共享写入由唯一集成者处理，或有显式授权证据。
- [ ] 状态、下一任务、进度、引用、决定和共享交接的同步情况已逐项记录。
- [ ] 下一任务只有一个，且输入、输出、验收和停止条件齐全。
- [ ] 交接中没有密钥、隐藏提示、私密聊天或无关个人数据。

发送交接前的判定

• 会话可恢复但项目输入未重新核对时，状态保持 draft。
• 局部工件与有限证据已交付、共享集成仍待执行时，可标记 delivered。
• 状态冲突、能力未知、权限缺口或需要人类取舍时，标记 blocked 并保留责任入口。
• 新稿、规则或来源使旧审查失效时，把旧包标为 superseded，不要让恢复会话继续沿用旧结论。

若目标工具是 Codex，使用附录 I重新填写其工具适配证据。两份模板共享目标、输入、产物、证据、风险和下一任务字段，但从不共享未经核验的产品能力。