Codex 新手第一小时
第一次用 Codex，不要从复杂 GitHub issue 开始。先用一个小仓库完成“只读摸底 -> 任务卡 -> 小改动 -> 看 diff -> 验证 -> 交付说明”的闭环。
推荐用 tastejs/todomvc-app-template：
git clone https://github.com/tastejs/todomvc-app-template.git codex-first-hour-todomvccd codex-first-hour-todomvcnpm install为什么选它：
- 项目小。
- 文件少。
- 用途明确。
- 不需要登录账号。
- 不涉及生产数据。
如果 npm install 失败，先不要让 Codex 修全局环境，先看 npm 命令找不到 或 安装命令报错。
10-20 分钟：只读摸底
Section titled “10-20 分钟：只读摸底”复制给 Codex：
这是我的 Codex 第一小时练习项目。请不要修改文件。
请只读摸底，输出：1. 这个项目做什么2. 主要页面文件在哪里3. CSS 文件在哪里4. 本地如何运行或预览5. 一个适合新手的最小改动任务6. 这个项目有哪些不该乱动的文件成功标志：
- Codex 能指出
index.html。 - Codex 能指出
css/app.css和js/app.js。 - Codex 没有直接开始改文件。
20-35 分钟：确认任务卡
Section titled “20-35 分钟：确认任务卡”让 Codex 把模糊目标变成任务卡：
请把“给页面加一个练习提示文案”整理成任务卡。
任务卡必须包含：- 要改哪些文件- 不改哪些文件- 预期页面变化- 验证方式- 如果发现需要新增依赖，请停止并说明原因你只需要确认：
- 文件范围是不是 1-3 个。
- 是否不新增依赖。
- 是否不改
package.json。
35-50 分钟：允许最小修改
Section titled “35-50 分钟：允许最小修改”复制给 Codex：
我确认这个任务卡。请执行最小修改。
约束：- 只改任务卡里列出的文件- 不新增依赖- 不改 package.json- 不改 Git 配置- 改完后先展示 diff 摘要- 给出本地验证步骤成功标志：
- diff 很小。
- 改动能从页面上看到。
- Codex 给出验证方式。
50-60 分钟：验收和复盘
Section titled “50-60 分钟：验收和复盘”复制给 Codex：
请基于当前 git diff 做交付说明。
输出：1. 改了什么2. 改了哪些文件3. 如何验证4. 如果我要撤回，应该看哪些 diff5. 这次经验是否值得写进 memory 或 skill失败时叫停句
Section titled “失败时叫停句”先停。请不要继续修改文件。请只基于当前 git diff 解释你已经改了什么，以及如何回退。为什么不从真实 issue 开始
Section titled “为什么不从真实 issue 开始”真实 issue 往往要求你理解上下文、复现步骤、测试命令和维护者意图。第一小时更应该学会：
- 只读摸底。
- 确认任务卡。
- 控制改动范围。
- 看 diff。
- 做验证。
- 写交付说明。
- 想控制任务范围：看 Spec / Skill / Memory 工作台三件套。
- 想并行做任务：看 Worktree 到 PR。
- 想让 Codex 看页面：看 Computer Use 安全指南。
访问日期：2026-06-17。命令和仓库状态发布前需要复测。