# Codex 会话交接模板

核验日期：2026-07-21

适用于切换会话、设备、协作者，或将长任务暂停后继续。

## 交接摘要

```md
### 目标

### 当前阶段

### 仓库与分支

### 开始基点
- commit：
- 工作区初始状态：

### 已完成

### 当前正在做

### 尚未完成

### 已修改文件

### 已运行命令
- 命令：
- 结果：passed / failed
- 关键输出：

### 已知问题与风险

### 不得修改

### 下一步第一条命令

### 完成标准
```

## 交接前检查

- [ ] `git status --short` 已记录。
- [ ] 未完成命令没有仍在后台运行。
- [ ] 测试结果与失败原因分开记录。
- [ ] 没有把密钥、Cookie、个人信息写入交接文件。
- [ ] 任何生产操作都注明是否已执行。
- [ ] 新会话不需要猜测当前基点、下一步和停止条件。

## 推荐保存位置

个人临时任务可以放在仓库外的私有工作记录中；团队任务建议保存为 `docs/handoffs/YYYY-MM-DD-topic.md` 或现有任务系统条目。交接文件不要代替 Git 历史，也不要记录任何生产密钥。若工作区有未提交的用户修改，必须明确哪些改动不是本任务产生的，避免下一位执行者误删。

## 新会话启动提示

```text
先读取交接摘要、项目 AGENTS.md 和当前 git status。不要重复已完成的步骤，不要覆盖现有用户修改。先验证摘要中的基点和第一条命令，再继续尚未完成的任务；若事实与摘要不一致，停止并报告差异。
```

## 交接质量评分

- A：目标、基点、改动、测试、风险和下一步全部可验证。
- B：可以继续，但仍需补查少量上下文。
- C：只有叙述，没有命令、文件或证据，不应直接继续编辑。

交接完成后由接手者先复核事实再操作；摘要是导航，不是对当前仓库状态的替代。

官方来源：

- https://learn.chatgpt.com/docs/codex/long-running-work
- https://learn.chatgpt.com/docs/codex/projects-and-chats