Free Preview
先试读：Codex 第一单不要追求大成果
第一次使用 Codex 的目标，不是让它立刻帮你做一个大功能，而是跑通“交任务、看过程、审结果、做决定”这条路径。
如果第一单选登录、支付、数据库或全站重构，你会同时面对太多不确定性：任务范围、代码风险、权限边界、验证方式、回滚方式。新手最应该先做的是低风险、可观察、可回退的小任务。
这篇能解决什么问题
- 知道第一次使用 Codex 前要准备什么仓库和权限。
- 会用只读项目地图确认 Codex 是否理解项目。
- 能完成一单低风险小改动，并看懂最基本的 diff 和验证结果。
付费后能看到哪些内容
- 第一次任务应该选什么、不要选什么
- 只读项目地图的标准输出
- 第一单小改动任务卡模板
- 完成后怎么判断能不能继续下一单
可以先照着试的一句话
请先只读项目，不要修改文件。输出这个项目的入口文件、运行方式、测试方式、高风险区域和 3 个适合第一单的小任务。
试读到这里，你应该先把第一单当成练流程，而不是追求一次做大功能。
第一次任务的目标：学会流程，不是炫技
你要验证的是“我能控制 Codex”，不是“Codex 能不能一次做完所有事”。
第一次任务应该让你学会五个动作：把任务说清楚、限制范围、看它怎么理解项目、看 diff、做验证。如果这五个动作没有跑通，后面再复杂的任务都不稳。
可观察
改完以后你能用眼睛或命令确认结果，例如标题变化、链接可访问、测试通过。
低风险
不碰登录、支付、数据库、权限、部署、外部发送和密钥。
范围小
最好只涉及 1-3 个文件，方便你看懂它到底改了什么。
能回退
如果结果不对，可以撤回这一小批改动，不影响其他工作。
准备一个低风险仓库，不要拿核心生产项目开第一单
如果你第一次就把公司核心项目交给 Codex，学习成本会被风险放大。
最适合第一单的项目，是一个你能看懂业务目标、可以本地或预览验证、不涉及真实用户数据的小项目。比如个人静态页、文档网站、练习仓库、小工具页面。
| 准备项 | 合格状态 | 不合格状态 |
|---|---|---|
| 项目类型 | 静态页、文档、练习小工具、低风险脚本。 | 支付、后台权限、真实数据库、生产部署脚本。 |
| 验证方式 | 能打开页面、跑测试、跑构建或手动检查。 | 你不知道改完怎么判断对错。 |
| 权限范围 | 只授权本次需要的仓库或目录。 | 一次性给太多仓库和组织权限。 |
| 任务大小 | 一处文案、一个链接、一个样式、一个只读检查。 | “帮我重构整个系统”。 |
第一单也可以做，但必须先让 Codex 只读输出项目地图，不允许改文件。等你确认它理解项目结构，再挑一个完全不碰核心业务的低风险改动。
第一轮只读：让 Codex 证明它找得到路
你不应该在 Codex 还没理解项目时，就让它开始改。
请先只读这个仓库，不要修改文件，不要创建分支，不要创建 PR，不要运行部署命令。
请输出：
1. 这个项目的主要用途
2. 主要入口文件和目录
3. 本地运行、测试、构建或预览方式
4. 高风险区域：登录、支付、数据库、权限、部署、外部发送、密钥
5. 适合第一单的 3 个低风险任务
6. 每个低风险任务的验收方式你要看它输出是否具体。如果它只说“这是一个前端项目，可以优化页面”，说明项目地图不够。合格输出应该包含文件路径、命令、风险区域和任务理由。
好信号
能列出具体路径、启动命令、测试命令、入口页面和禁区。
坏信号
泛泛总结项目，找不到验证方式，或者建议第一单就改高风险逻辑。
第一单小改动怎么选：让它小到你能完整审完
一个好的第一单，应该让你 10 分钟内看完全部改动。
文案改动
改一个标题、摘要、按钮文案。验收方式是页面出现新文案。
链接修复
修一个 404 链接。验收方式是点击或 curl 返回 200。
移动端样式
修一个卡片溢出或按钮遮挡。验收方式是 375/390px 视口检查。
只读检查脚本
补一个链接检查或索引检查，不改业务逻辑。
任务：修复一个低风险页面问题
目标：把 /docs/start.html 的按钮文案从“开始”改成“开始第一步”
范围：只允许修改 /docs/start.html
禁区：不要修改 CSS、JS、登录、支付、数据库、部署文件
验收：
1. 页面中出现“开始第一步”
2. 除目标文件外没有其他文件改动
3. 如果生成 diff，请说明改动行和原因看 diff 和验证结果：不要只看 Codex 的总结
Codex 的总结可以帮你理解，但不能替代证据。
请自查这次第一单：
1. 实际修改了哪些文件
2. 每个文件为什么必须修改
3. 是否完全符合任务范围
4. 做了哪些验证，结果是什么
5. 有没有未验证部分
6. 如果我不同意这次结果，应该如何撤回Codex 第一单完整模板
可以直接复制，先跑只读地图，再选小任务。
我第一次使用 Codex。请按两个阶段执行。
阶段 1：只读项目地图
- 不修改文件
- 不创建 PR
- 不运行部署、上传、删除、外部发送命令
- 输出项目入口、运行方式、测试方式、高风险区域、适合第一单的低风险任务
阶段 2：等我确认后，再执行第一单
- 第一单必须只涉及 1-3 个文件
- 必须有明确验收方式
- 不做顺手重构
- 完成后输出实际 diff、验证结果、未验证项、撤回方式- 你知道 Codex 看到了哪些文件和目录。
- 你知道它为什么改这些文件。
- 你能看懂 diff 的大意。
- 你能用一个明确动作验证结果。
- 你知道结果不对时怎么撤回或重开任务。