模板：Codex 协作记录

协作记录的作用，是证明你不是“让 AI 随便生成”，而是有流程、有边界、有检查地使用 Codex。

这份模板适合放在：

项目 README 后面。
作品集页面里。
面试准备文档里。
简历项目经历的素材库里。

完整模板

# Codex 协作记录

## 任务名称

例如：给课程列表页增加关键词搜索

## 任务背景

说明为什么要做这个任务。

示例：
课程列表已有基础展示能力，但无法按关键词快速查找课程。需要在不改变接口协议的前提下，增加前端关键词筛选能力。

## 我给 Codex 的输入

我提供了这些信息：

- 当前需求：
- 允许修改的范围：
- 不允许修改的范围：
- 需要保留的行为：
- 验收标准：

## Codex 参与的环节

Codex 参与了：

1. 只读分析项目结构
2. 找到相关页面和组件
3. 生成改动计划
4. 辅助完成局部修改
5. 解释 diff 和潜在风险
6. 整理验收路径

## 我的判断

我自己负责判断：

- 需求是否理解正确：
- 改动范围是否合理：
- 是否有无关文件变更：
- 是否影响已有功能：
- 是否需要补充检查：

## 改动范围

本次改动涉及：

| 文件 | 改动说明 |
| --- | --- |
| 文件路径 | 做了什么 |
| 文件路径 | 做了什么 |

## 检查结果

| 检查项 | 结果 | 说明 |
| --- | --- | --- |
| 页面打开 | 通过 / 未通过 |  |
| 核心交互 | 通过 / 未通过 |  |
| 异常情况 | 通过 / 未通过 |  |
| 构建或测试 | 通过 / 未通过 |  |

## 剩余风险

如果还有没完全覆盖的点，写在这里。

-
-

## 复盘

这次任务里 Codex 帮助我：

-
-

我自己主要负责：

-
-

下次类似任务可以改进：

-
-

给 Codex 的配套提示词

你可以这样让 Codex 帮你整理协作记录：

请根据本次任务过程，按照下面结构整理一份 Codex 协作记录：

1. 任务名称
2. 任务背景
3. 我给 Codex 的输入
4. Codex 参与的环节
5. 我的判断
6. 改动范围
7. 检查结果
8. 剩余风险
9. 复盘

要求：
- 不要夸大 Codex 的作用
- 不要编造没有执行过的检查
- 不确定的地方标记为“待补充”
- 语言专业直接，适合放进求职作品集

最后提醒

协作记录不是为了证明 Codex 多厉害。

它是为了证明你会使用 Codex，并且知道如何控制它、检查它、对结果负责。