Codex App 新手课 12：Codex 能做什么，从文档到代码慢慢放大

学到这里，你已经完成了最重要的入门动作。

你会准备练习文件夹。

你会让 Codex 先读项目。

你会看它有没有读懂。

你会让它只改一个 README.md。

你也知道权限提示出现时，要先看目的、范围和风险。

到这一课，再来聊“Codex 能做什么”，就不会飘。

因为你已经知道一件事：

Codex 不是用来一次性许愿的。

它更适合被你带着，一步一步完成任务。

第 12 课不要求你马上做复杂项目。

这一课只帮你建立一条能力阶梯：

解释文件 -> 整理文档 -> 修改一个文件 -> 检查报错 -> 做小工具 -> 协作完整项目

每一步只比上一步大一点。

这才是新手最稳的学习方式。

先别问“它最强能做什么”

很多人第一次接触 Codex，会先问：

它到底能不能写代码？
它能不能做网页？
它能不能帮我做软件？
它能不能把一个项目全改好？

这些问题都可以问。

但对新手来说，第一天更重要的问题是：

我现在能看懂哪一级任务？

如果你看不懂它的计划，看不懂它改了哪些文件，看不懂它为什么要权限，那任务越大，越容易失控。

所以第 12 课先给你一个判断标准：

能看懂，就可以逐步放大。
看不懂，就先缩小任务。

第一类：解释文件

这是最适合新手的任务。

你把一个文件夹交给 Codex，让它先告诉你里面有什么。

比如：

请阅读这个练习文件夹，告诉我每个文件大概是做什么的。请用小白能听懂的话解释。先不要修改任何文件。

这个任务很安全。

因为你没有让它动手改文件。

你只是让它帮你把陌生文件夹讲清楚。

适合这些场景：

• 你第一次打开一个项目。
• 你下载了一份课程资料。
• 你看到一堆文件名，不知道先看哪个。
• 你想知道某个文件夹大概是什么结构。

这一类任务练的是：

让 Codex 先读懂，再让你读懂。

如果它解释得太专业，你可以继续说：

请换成新手能听懂的话，每个文件只解释 1 到 2 句话。

第二类：整理文档

当你能听懂它对文件的解释，就可以让它帮你整理文档。

比如：

请阅读这个文件夹里的 Markdown 文档，整理出一个适合新手学习的目录建议。先不要修改文件，只给我建议。

注意最后一句：

先不要修改文件，只给我建议。

这句话很重要。

它把任务停在“建议阶段”。

你可以先看它整理得对不对，再决定要不要让它动手。

适合这些场景：

• 整理教程目录。
• 整理公众号选题。
• 整理课程资料。
• 整理项目说明。
• 从一堆笔记里提炼结构。

这一类任务练的是：

先让 Codex 帮你看结构，而不是直接改内容。

如果它给的目录太大，你可以说：

这个目录太大了。请压缩成 5 个以内的小节，适合第一次学习的人阅读。

第三类：修改一个文件

这是第 10 课已经练过的动作。

比如：

请只修改 README.md，补充一个“如何开始使用”的小节。先告诉我准备怎么改，等我确认后再动手。

这类任务比前两类更进一步。

因为它开始真正修改文件了。

所以你要守住三个边界：

1. 只改一个文件。
2. 先说方案。
3. 改完看 Review / Diff。

适合这些场景：

• 补充 README。
• 改一段文案。
• 调整某篇教程的小节顺序。
• 修正一个明显的小问题。
• 给文件补一个简短说明。

这一类任务练的是：

让 Codex 小范围动手，并且你能检查结果。

不要一上来就让它“整理整个项目”。

先让它改一个你能看懂的文件。

第四类：检查报错

如果你有一点项目操作经验，后面可以让 Codex 帮你看报错。

比如你运行某个项目时，看到一段错误提示。

你可以这样说：

我运行项目时出现下面这个报错。请先结合当前项目文件分析可能原因，先不要修改文件。

[把报错粘贴在这里]

这里最重要的不是报错本身。

最重要的是：

先分析，不要马上修。

新手看到报错很容易急。

但越急，越容易让 Codex 一口气改很多文件。

你可以先让它回答三件事：

1. 这个报错大概是什么意思。
2. 最可能的原因有哪些。
3. 如果要修，第一步应该检查哪个文件。

适合这些场景：

• 项目启动失败。
• 页面显示异常。
• 某个脚本运行报错。
• 文档转换失败。
• 一个小工具没有按预期输出。

这一类任务练的是：

先定位问题，再决定是否修改。

如果它直接要改很多文件，你可以把它拉回来：

先不要修改。请只列出最可能的 3 个原因，并说明第一步应该检查哪里。

第五类：做小工具

当你熟悉前面的流程后，可以让 Codex 做一个小工具。

这里的“小工具”，不是大系统。

它可以是：

• 一个简单网页。
• 一个批量重命名脚本。
• 一个 Markdown 检查工具。
• 一个表格整理脚本。
• 一个把资料目录生成清单的小脚本。

这类任务会涉及更多文件，也可能涉及运行命令。

所以第一句话要更谨慎：

我想做一个小工具，用来整理当前文件夹里的 Markdown 文件。请先阅读项目，告诉我你准备怎么实现、会新增或修改哪些文件。先不要创建或修改文件。

你先看它的方案。

确认方案足够小，再让它做第一步。

不要一上来就让它全部做完。

可以拆成这样：

第一步先只创建一个最小可运行版本。
先不要美化界面，也不要增加额外功能。

这一类任务练的是：

让 Codex 做一个可检查的小成果。

小成果比大承诺更重要。

第六类：协作完整项目

完整项目是进阶阶段。

它可能涉及：

• 多个文件。
• 多个目录。
• 运行命令。
• 安装依赖。
• 测试。
• 调整界面。
• 修复错误。
• 多轮确认。

这时候你前面学过的能力都会用上：

• 限制范围。
• 看懂计划。
• 分步确认。
• 检查改动。
• 看懂权限。
• 出问题时缩小任务。

如果你真的要做一个完整项目，不要直接把目标丢过去。

先让它拆：

请先把这个目标拆成 3 到 5 个小步骤。每一步说明要做什么、会影响哪些文件、完成后我应该怎么检查。先不要修改文件。

然后只做第一步。

第一步完成并检查通过，再做第二步。

完整项目不是不能做。

只是不能跳过过程。

大任务先拆小

第 12 课最重要的不是记住六类能力。

最重要的是学会把大任务变小。

当你想说一个很大的需求时，先停一下。

把它改成四步：

1. 先读项目。
2. 先给方案。
3. 只做一个小改动。
4. 检查后再放大。

比如你原本想说：

请帮我整理整个教程项目。

可以改成：

请先阅读这个教程项目，告诉我你认为当前目录结构是否清楚。先不要修改文件。

再下一步：

请只针对 README.md 给出修改建议，先不要修改。

再下一步：

请只修改 README.md 的课程目录部分，其他文件不要动。先告诉我你准备怎么改，等我确认后再修改。

你看，同样是整理项目。

拆小以后，你就能看懂每一步。

新手第一阶段适合做什么

如果你刚学完前 11 课，建议先练这些任务：

• 解释一个练习文件夹。
• 总结 3 个 Markdown 文件。
• 给 README 补一段说明。
• 把一篇文档改得更适合新手读。
• 让 Codex 列出某次修改影响了哪些文件。
• 让 Codex 把一个大任务拆成 3 个小任务。

这些任务不炫。

但它们能帮你建立一个很关键的能力：

我知道自己交给 Codex 的任务有多大。

这个能力，比背功能更重要。

什么时候可以放大任务

不是永远只做小任务。

任务可以放大。

但要满足几个条件：

1. 你能看懂它的计划。
2. 你能看懂它要改哪些文件。
3. 你知道权限为什么出现。
4. 你能检查改动结果。
5. 出错后你知道怎么缩小范围。

这些条件满足得越多，任务就可以越大。

如果这些条件一个都不满足，就先回到小任务。

这不是退步。

这是掌握节奏。

这一课不要做什么

第 12 课不要做这些事：

• 不要一上来让 Codex 处理重要项目。
• 不要把整个桌面交给它练习。
• 不要一次让它改几十个文件。
• 不要让它运行你完全看不懂的命令。
• 不要把“能做”理解成“应该马上做”。
• 不要跳过计划、确认和检查。

Codex 很强。

但新手最先要练的不是让它强。

是让它可控。

这一课的小练习

你可以用第 02 课准备的练习文件夹做一个能力阶梯练习。

第一步，解释文件：

请阅读这个练习文件夹，告诉我 README.md、notes.md、todo.md 分别是做什么的。先不要修改文件。

第二步，整理文档：

请根据这 3 个文件，给我一个适合新手学习的目录建议。先不要修改文件。

第三步，修改一个文件：

请只修改 README.md，补一段“如何使用这个练习文件夹”的说明。先告诉我方案，等我确认后再修改。

第四步，检查改动：

请列出你刚才修改了哪些文件，以及每个文件改了什么。

这四步跑完，你就能感受到：

任务是可以一点点放大的。

这一课的检查清单

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

1. 我知道 Codex 的能力要按阶梯练吗？
2. 我能区分解释文件、整理文档、修改文件这几类任务吗？
3. 我知道修改文件前要先看方案吗？
4. 我知道看报错时要先分析，不要马上修吗？
5. 我知道做小工具时要先做最小版本吗？
6. 我知道完整项目要先拆步骤吗？
7. 我能把一个大任务缩小成一个小任务吗？
8. 我知道任务放大前要先能检查结果吗？

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

这一课的结论

Codex 能做很多事。

但新手真正要学的，不是把功能表背下来。

而是掌握这条节奏：

先理解 -> 再计划 -> 小范围修改 -> 检查后放大

你能控制任务大小，就能慢慢用好 Codex。

下一课，我们会把前面学过的常用话术整理成速查表。

卡住时，不用临时想怎么说，直接复制模板再按自己的任务改。