浏览 AI 知识库
Codex首次任务：完成小改动、验证与回滚
第一次让 Codex 改已有项目，先别急着让它动手。把目标文件、不能碰的改动、验证命令和撤销办法说清楚，一个小改动才适合作为起点。
沿完整工作流推进
前一阶段的可检查结果，是下一阶段的输入；中间证据不足时停在当前阶段。
第一次交给 Codex 的任务，最好小到半小时内能验收
新同事第一次让 Codex 改已有项目，任务只是把搜索空状态从“暂无数据”改成“没有找到结果”。工作区里却已有别人未提交的支付页面改动，直接让 Agent 自由处理很容易误伤。
- 改动前后 `git status` 已保存
- diff 只包含授权文件
- 验证命令与回滚路径可执行
先确认这次任务的起点、边界和交付
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | Windows PowerShell；已有 Vite 项目；`git status --short` 显示 `src/pay.ts` 被修改；本次只允许改 `src/search/EmptyState.tsx` 和对应测试。 |
| 不能越过的边界 | 不碰已有支付改动，不安装新依赖，不提交和部署；修改前记录版本与状态，测试失败就保留现场。 |
| 要交付的结果 | 版本记录、小改动 diff、测试与回滚证据 |
从“核对环境”走到“实际回滚一次”
| 当前阶段 | 实际处理 |
|---|---|
| 核对环境 | 记录 Windows 与 PowerShell 版本、Node.js 版本、当前目录和 Codex 实际版本。命令不存在时保留原始错误，不临时混用多个安装来源。 |
| 建立可回滚起点 | 在测试仓库提交或复制基线，确认工作区没有不明改动；告诉 Codex 只处理一个文件和一个可检查结果。 |
| 完成一个小改动 | 选择改一处文案、补一个测试或修一个局部错误，先让 Codex说明将读哪些文件、执行哪些验证。 |
| 检查 diff 和测试 | 人工查看修改范围，运行仓库真实测试或构建命令，记录输出与退出码。测试不存在就如实写明。 |
| 实际回滚一次 | 用 Git 反向提交、恢复补丁或备份撤销本次小改动，确认回滚步骤有效后再接真实任务。 |
把搜索空状态改成可检查的第一次任务
| 字段 | 本例输入 | 通过标准 |
|---|---|---|
| 目标 | 将 `暂无数据` 改成 `没有找到匹配结果，请换一个关键词` | 只改搜索结果为空时显示的文案 |
| 范围 | `content/search-copy.mjs` 与对应生成页 | 不触碰搜索逻辑、样式、其他空状态 |
| 验证 | `npm run build`、`npm run verify:search` | 生成页文本与源文案一致，命令退出码为 0 |
| 回滚 | 保存补丁后恢复原文案 | 恢复后再次构建，页面回到原始文本 |
这是教学示例，不代表当前仓库真的存在这些路径；接手真实项目时必须替换成实际文件和命令。
看到测试通过，也要确认改动真的落在源文件
生成页变了，但下次构建又恢复
- 原因
- 直接编辑了生成 HTML，没有修改内容源。
- 怎么改
- 沿构建命令反查源文件，撤销生成目录的临时编辑，再从源文件重建。
回滚后页面仍显示新文案
- 原因
- 只恢复了源码，缓存或生成物没有重新构建。
- 怎么改
- 记录回滚命令、重新构建并用页面文本做回归检查。
第一次给 Codex 派活，可以直接使用这份任务说明
先把目标文件、现有脏改动和验证命令写清楚，再允许Agent动手。
可复制使用
第一次给 Codex 派活，可以直接使用这份任务说明
请先把下面这项小任务变成一份可执行、可撤销的 Codex 任务卡；这一轮只读，不修改文件。 项目目录/当前分支【】；git status【】；想修复的具体行为与复现方式【】；允许修改范围【】；禁止操作【】；已知测试命令【】。 任务卡要明确：目标行为、允许读取/修改的路径、已有脏改动如何保护、验收测试和停止条件。仓库规则或路径未确认时列问题，不要猜。完成后列出预期触及文件与回滚边界，等我检查任务卡再动手。
使用范围：先把目标文件、现有脏改动和验证命令写清楚，再允许Agent动手。不要覆盖工作区已有改动，不升级依赖，不修改任务外文件。
完成后的版本记录、小改动 diff、测试与回滚证据
最终 diff 只改一处文案并补一个空结果测试；`npm test -- EmptyState` 通过，`git status --short` 仍显示原来的 pay.ts 和本次两个文件。回滚说明给出恢复本次文件的精确路径，没有声称项目整体完成。