Codex App 新手课 10：第一次小修改，让它补 README

前面几课，我们一直让 Codex 先读、先观察、先解释。

到第 09 课，你已经学会看它有没有读懂项目：

文件列表 -> 项目理解 -> 下一步建议 -> 是否要改文件

如果这四层都没问题，第 10 课就可以让它做第一次真正的小修改。

但注意，第一次不要追求“做得多”。

这一课只练一件事：

让 Codex 只修改 README.md，给练习项目补一段简短说明。

你要练的不是写出多漂亮的内容，而是学会控制范围：

1. 只改一个文件。
2. 先让它说方案。
3. 你确认后再改。
4. 改完以后看改动。

这套流程练会了，以后再让 Codex 改文章、改网页、改代码，心里会稳很多。

为什么第一次选 README

README.md 通常是一个项目的说明文件。

你可以把它理解成这个文件夹的“门口说明牌”。

一个陌生人第一次打开这个文件夹，先看 README，就应该知道：

• 这个项目是干什么的。
• 文件夹里大概有什么。
• 新手应该从哪里开始。

第一次练习选 README，有三个好处。

第一，它容易看懂。

README 通常是文字说明，不是复杂代码。就算你不会编程，也能判断它写得像不像人话。

第二，它风险低。

我们只让 Codex 补一段说明，不碰系统文件，不碰私人资料，也不改多个文件。

第三，它方便检查。

改完之后，你只需要看一个文件：README.md。

新手阶段最重要的不是“一次完成大任务”，而是“知道发生了什么”。

这一课的任务边界

开始之前，先把边界说清楚。

这一课允许 Codex 做：

• 阅读练习文件夹。
• 修改 README.md。
• 补一段简短项目说明。
• 告诉你它改了哪里。

这一课暂时不做：

• 不修改 notes.md。
• 不修改 todo.md。
• 不创建新文件。
• 不运行命令。
• 不整理整个项目。
• 不把内容扩成完整文档。

这不是限制 Codex 的能力。

这是给新手留下可检查的空间。

第一次改动越小，你越容易建立判断力。

可以复制这条指令

在 Codex App 底部输入框里，复制这段话：

请只修改 README.md，给这个练习项目补一段简短说明。

说明要让第一次打开这个文件夹的人知道：这个文件夹是用来练习 Codex App 的。

先告诉我你准备怎么改，等我确认后再修改。

这条指令看起来不长，但里面有三个关键动作。

第一句：

请只修改 README.md

这是限制文件范围。

新手不要一上来就说“把这个项目整理一下”。这种说法太大，Codex 可能会动很多地方，你也很难检查。

第二句：

给这个练习项目补一段简短说明

这是限制任务大小。

不是让它重写整个 README，也不是让它做完整教程，只是补一段说明。

第三句：

先告诉我你准备怎么改，等我确认后再修改。

这是让 Codex 先停在“方案阶段”。

你先看它打算怎么做，再决定要不要让它动手。

发送前再看三眼

这一步很像发消息之前检查收件人。

按下发送之前，先看三眼：

第一眼，看当前项目是不是练习文件夹。

如果左侧项目不是你准备的练习文件夹，先停下。

第二眼，看指令里是不是写了 README.md。

如果只是写“帮我整理项目”，范围就太大了。

第三眼，看最后有没有写“先告诉我方案，等我确认后再修改”。

这句话很关键。

它能把 Codex 从“直接动手”拉回“先说明计划”。

先看它的方案

发送后，Codex 可能会先回复一个方案。

你不用逐字研究。

先看四件事：

1. 它是不是只准备改 README.md。
2. 它要补的内容是不是“项目说明”。
3. 它写得是不是适合新手。
4. 它有没有顺手想改别的文件。

如果它的方案是这样的：

我准备在 README.md 开头补充一段项目说明，告诉读者这个文件夹用于练习 Codex App，并简单说明 README.md、notes.md、todo.md 分别用来做什么。

这就比较合适。

因为它说清楚了：

• 改哪个文件。
• 改什么内容。
• 为什么这样改。

如果方案太大，先把它缩小

有时 Codex 会给一个看起来很积极的方案。

比如它可能说：

我可以顺便整理 notes.md 和 todo.md，并补充一个完整学习计划。

这时不要急着同意。

你可以回复：

这一次先只改 README.md，其他文件不要动。请把方案缩小到只补一段简短项目说明。

如果它写得太像技术文档，你可以回复：

请写得更像给第一次打开这个文件夹的新手看的说明，不要写得太专业。

如果它写得太长，你可以回复：

请压缩到 3 到 5 句话。

你不需要一次就把指令写到完美。

会把任务缩小，本身就是使用 Codex 的核心能力。

确认后再让它修改

如果方案没问题，你再回复：

可以，按这个方案修改 README.md。

这句话就是正式授权它进入修改阶段。

它修改完成后，通常会告诉你类似：

已修改 README.md。

看到这句话，不要马上结束。

第 10 课真正关键的地方在后面：

改完以后，要看改动。

改完以后看哪里

Codex 修改完成后，你要找到它展示改动的地方。

在 Codex App 里，通常会有文件变更、Review、Diff 或类似的改动区域。

你可以把它理解成：

这里不是看它说了什么，而是看它实际改了什么。

重点看四个问题：

第一，文件对不对。

本课只允许改 README.md。

如果你看到 notes.md、todo.md 或其他文件也被改了，就先不要继续。

第二，内容短不短。

第一次只补简短说明，不需要长篇大论。

第三，有没有多改。

它有没有删掉原来的内容？有没有顺手改标题？有没有新增你没要求的东西？

第四，自己能不能看懂。

如果新增内容你自己都看不懂，说明它没有写给新手。

可以让它解释刚才改了什么

如果你看不懂改动区域，可以继续问：

请用新手能听懂的话，说明你刚才具体修改了 README.md 的哪几处。

这句话很实用。

它会把“改动审查”翻译成你能理解的说明。

你也可以让它更具体一点：

请只列出本次修改的文件名，以及每个文件改了什么。

理想情况下，它应该只列出：

README.md：新增了一段练习项目说明。

如果它列出了多个文件，就说明你要回头检查。

如果它多改了文件怎么办

多改文件不一定是灾难。

但第 10 课的目标是控制范围，所以要把它拉回来。

你可以这样说：

这一次只允许修改 README.md。请撤回对其他文件的修改，只保留 README.md 里的简短项目说明。

如果你不确定它有没有撤回，可以继续问：

现在请再次列出本次仍然保留修改的文件。只列文件名。

你要看到的结果应该是：

README.md

这个动作看起来有点慢，但它是在训练你看边界。

边界看得清，后面才敢做更大的任务。

如果内容不满意怎么办

不满意很正常。

用 Codex 做事，不是一次命令就结束，而是来回调整。

如果它写得太正式，你可以说：

这段说明太像技术文档了，请改得更像给新手看的说明。

如果它写得太啰嗦，你可以说：

这段太长了，请压缩到 3 句话。

如果它没有说清楚文件夹用途，你可以说：

请补一句：这个文件夹只是练习用，不放真实重要资料。

注意，这些都是小调整。

你仍然围绕 README.md 一个文件来做。

这一课不要做什么

第 10 课已经开始修改文件了，所以比前几课更要慢一点。

这一课不要做这些事：

• 不要让它一次改多个文件。
• 不要让它顺手创建新文件。
• 不要让它把 README 扩成完整教程。
• 不要看到“完成了”就直接进入下一课。
• 不要忽略 Review / Diff 里的实际改动。
• 不要把你看不懂的修改当成正常结果。

第一次小修改，不是看 Codex 有多能干。

是看你能不能管住任务边界。

这一课的小练习

你可以按下面步骤完整练一遍：

1. 打开第 02 课准备的练习文件夹。
2. 确认里面有 README.md、notes.md、todo.md。
3. 输入本课提供的指令。
4. 等 Codex 先给方案。
5. 确认它只准备改 README.md。
6. 回复“可以，按这个方案修改 README.md。”
7. 修改完成后查看改动区域。
8. 确认只改了 README.md。
9. 打开 README.md 自己读一遍新增内容。
10. 如果不满意，只围绕这段说明继续调整。

这 10 步跑完，你就完成了第一次真正的 Codex 小任务。

这一课的检查清单

用下面 8 个问题检查自己：

1. 我知道为什么第一次选 README.md 吗？
2. 我有没有把任务限制在一个文件里？
3. 我有没有让 Codex 先说方案？
4. 我有没有确认方案后再让它修改？
5. 我有没有查看改动区域，而不是只看它说“完成了”？
6. 我能判断是否只改了 README.md 吗？
7. 如果它多改了文件，我知道怎么让它撤回吗？
8. 如果新增内容不适合新手，我知道怎么让它改短、改白话吗？

如果这些问题都能回答“是”，第 10 课就过关了。

这一课的结论

第一次小修改，真正重要的不是 README 多漂亮。

真正重要的是你练会了一个安全流程：

限定文件 -> 先看方案 -> 确认修改 -> 审查改动

只要这个流程稳了，Codex 就不再只是一个聊天框。

它会开始变成一个你能控制边界的项目助手。

下一课，我们再专门讲一个更关键的问题：

当它申请权限时，什么时候可以同意，什么时候应该先停下。