Codex App 新手课 14：实操展示，用一个项目跑完整工作流

前面 13 课，我们已经把 Codex App 的上手动作拆开学了一遍：

• 怎么理解它和普通聊天 AI 有什么不同。
• 怎么准备安全练习文件夹。
• 怎么安装、登录、打开项目。
• 怎么看懂界面、发第一条指令。
• 怎么看回复、做第一次小修改、判断权限。
• 怎么用提示词模板处理常见问题。

第 14 课不再讲一个新按钮。

这一课把前面的动作串起来，用一个真实项目跑一遍完整工作流。

你会看到，真正使用 Codex App 时，一句“把这件事全做完”太粗了，后面很容易失控。

更稳的方式是：

先确认项目，再只读扫描；
先诊断问题，再给任务单；
先小范围修改，再审查改动；
先做交付检查，再准备发布。

这次实操要练什么

我们就用这套教程项目当例子。

你可以把它想象成一个普通资料文件夹：里面有教程 Markdown、图片、练习文件夹和发布清单。

这次实操要练 6 件事：

1. 让 Codex 确认自己正在看哪个项目。
2. 让 Codex 只读扫描项目结构，先不要修改。
3. 让 Codex 从新手读者角度诊断问题。
4. 把诊断结果变成一个边界清楚的小任务。
5. 修改完成后看 Review / Diff。
6. 交付前检查图片、链接、读者视角和发布场景。

你自己的项目不一定是教程。

它也可以是课程资料、公众号文章合集、小工具项目、论文笔记、活动方案。

只要它是一个文件夹，就可以按这个流程练。

第一步：确认当前项目

先看 Codex App 左侧。

你要确认：当前打开的是你准备练习的项目，而不是桌面、下载目录，也不是另一个私人资料文件夹。

第一次练习时，建议你发这条：

请先确认当前打开的是哪个项目。
请告诉我：项目里大概有哪些文件和文件夹，以及你认为它们分别是做什么的。
先不要修改任何文件。

这句话里最重要的是最后一句：

先不要修改任何文件。

因为你现在还没有让它做事。

你只是让它看清楚桌面上摆了哪些材料。

合格的回复应该能说清楚：

• 根目录里有哪些主要 Markdown 文档。
• images/ 里放的是教程配图和截图。
• practice-project/ 是给新手练习用的小文件夹。
• source-notes/ 是资料摘记。
• publish-checklists/ 是后续发布时用的检查清单。

如果它只说“我看到了一个教程项目”，还不够。

你可以继续追问：

请按文件夹列出你看到的结构，并用新手能听懂的话说明每一类文件的作用。
还是不要修改文件。

第二步：只读扫描

只读扫描是 Codex 工作流里很重要的一步。

它的价值不在于让 Codex 表演“我读到了很多文件”。

这一步是为了让你确认三件事：

1. 它看的是不是正确项目。
2. 它有没有理解文件之间的关系。
3. 它有没有在你授权之前乱动文件。

你可以复制这条：

请先阅读这个教程项目，告诉我你看到了哪些文件和文件夹。
请按“教程正文、图片资源、练习项目、资料摘记、发布清单”分类说明。
先不要修改任何文件。

如果回复太长，你不用每个字都读。

先盯住这 4 个点：

• 文件名有没有对得上。
• 文件夹用途有没有说反。
• 有没有提到它准备修改文件。
• 有没有漏掉重要目录。

只要这 4 个点没有问题，就可以进入下一步。

第三步：让它从读者角度诊断

读懂项目以后，不要马上让它改。

先让它站在读者角度诊断。

这里的“读者角度”很关键。

做教程时，内容多不等于新手能看懂。

最容易出问题的地方，是作者自己懂了，却忘了小白卡在哪里。

可以这样问：

请从第一次学习 Codex App 的新手角度，检查这套教程的学习顺序和内容缺口。

重点看：
1. 哪些地方跳得太快。
2. 哪些地方缺少实际截图或必要配图。
3. 哪些话像作者备注，不适合直接给读者看。
4. 哪些章节之间衔接不顺。

先只给判断，不要修改文件。

你要看的不是它有没有夸项目完整。

你要看它能不能指出具体问题。

比如：

• 第 08 课讲第一条指令，第 09 课讲看懂回复，中间逻辑是否连贯。
• 第 10 课第一次小修改是否足够小。
• 第 11 课权限判断有没有提前解释风险。
• 第 13 课模板能不能自然过渡到第 14 课实操。
• 第 14 课是否真的像读者可执行的练习，而不是作者制作记录。

如果它说得太泛，就让它收窄：

请把问题分成两类：
1. 影响新手理解、必须优先处理的问题。
2. 可以以后再优化的问题。

每一项都要说明：出现在第几课，为什么会影响读者。
先不要修改文件。

第四步：把诊断变成小任务

到这一步，Codex 已经读过项目，也诊断过问题。

现在才开始给任务。

第 13 课讲过一个通用公式：

目标 + 材料 + 边界 + 交付物

我们把它用到这个真实项目里：

我的目标是：把第 14 课改成面向新手读者的完整实操展示。

请参考：
1. 第 08 到第 13 课的学习顺序。
2. images/ 文件夹里已有的 Codex App 截图。
3. 当前第 14 课的原稿。

边界是：
1. 先只修改第 14 课。
2. 不改其他教程正文。
3. 不删除已有截图。
4. 不写给作者看的制作说明。

交付物是：
先给我一份第 14 课修改方案，列出你准备保留哪些截图、补充哪些结构图、正文会分成哪几部分。

先不要修改文件，先告诉我你的理解和计划。

这段话看起来长，但它没有复杂技巧。

它只是把事情说清楚：

• 你要它改什么。
• 它应该参考什么。
• 哪些文件不能乱动。
• 先交方案，不要直接下手。

这就是让 Codex 稳定工作的关键。

第五步：确认方案后再修改

Codex 给出方案以后，你不要只看“写得挺详细”。

重点看 4 个问题：

1. 它有没有说清楚会改哪些文件。
2. 它有没有把任务控制在第 14 课。
3. 它有没有明确要用哪些图片。
4. 它有没有继续保持读者视角。

如果方案太大，比如它想顺手改完整套教程，可以这样收住：

这次先缩小范围。
请只修改第 14 课，其他教程正文暂时不要动。
如果你认为其他文件需要同步，请先列出来，等我确认后再改。

如果方案可以，就发：

方案可以。

请按这个方案修改第 14 课。

要求：
1. 正文要像给新手上课，读者可以照着操作。
2. 保留真实 Codex App 截图，帮助读者看懂界面。
3. 增加完整工作流图和交付检查图。
4. 所有图片都用 Markdown 正常引用。
5. 修改完成后，请告诉我改了哪些文件、用了哪些图片、还需要检查什么。

注意，你没有把控制权完全交出去。

你是在一步步放大授权。

先让它看。

再让它判断。

再让它给方案。

最后才让它改。

第六步：看 Review / Diff

只要 Codex 改了文件，就要看 Review / Diff。

这一步不要省。

你第一次看 Diff，可能会觉得密密麻麻。

不用怕。

先只看 5 件事：

1. 文件数量是不是合理。
2. 有没有改到你没允许的文件。
3. 有没有删掉重要内容。
4. 图片路径是不是写对了。
5. 教程正文里有没有还没清理的作者备注。

如果你看不懂，可以让 Codex 解释：

请用新手能看懂的话解释这次 diff。
按文件分组说明：
1. 为什么改。
2. 改了什么。
3. 我应该重点检查哪里。

如果你看到类似提交窗口，也不要急着继续。

先看 Changes 里的文件数量。

它应该和你的任务规模大致匹配。

如果你只让它改第 14 课，却出现十几个无关文件，就先停下来问：

我只要求修改第 14 课。
请解释这次为什么出现这些文件变动。
哪些是必须的，哪些可以先不动？
先不要继续提交。

第七步：交付前检查

很多新手会在 Codex 说“完成了”的时候停下。

但真正可交付的资料，还要过一遍检查。

你可以直接发：

请检查第 14 课：

1. 图片引用是否都能找到对应文件。
2. 本地 Markdown 链接是否有效。
3. 正文是否还有作者侧说明、占位文字、未完成标记。
4. 本次是否只修改了我允许的文件。
5. 新增图片是否写入 images/README.md。
6. 公众号和小红书发布清单是否需要同步。

先只报告结果，不要顺手修改。
如果发现问题，请列出来等我确认。

这一步的重点是：

先报告，不要顺手改。

因为检查和修改是两件事。

如果你让它边查边改，有时候问题会越滚越大。

先把问题列清楚，再决定哪些要处理。

第八步：从发布场景再看一遍

本地 Markdown 能读，不代表适合直接发到平台。

同一篇教程，放到不同地方，处理方式不一样。

你可以问：

请从公众号、小红书、飞书资料库三个场景检查第 14 课。

分别告诉我：
1. 哪些段落适合直接用。
2. 哪些段落需要改短或拆页。
3. 哪张图适合放在第一屏。
4. 发布前还要人工重点看哪一处。

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

一般会得到类似判断：

• 公众号：适合保留完整讲解，重点看开头是否抓住读者困惑。
• 小红书：适合拆成多页，每页只讲一个动作。
• 飞书资料库：适合按步骤拆成知识库页面，方便以后搜索和复用。

这一步先不急着发布。

它是让你提前知道：同一份源文档，后面怎么迁移到不同平台。

一次完整实操长什么样

你可以把第 14 课的流程记成 8 句话：

1. 我先确认当前项目。
2. 我让 Codex 只读扫描。
3. 我让它从读者角度诊断。
4. 我把诊断变成小任务。
5. 我确认方案后再让它修改。
6. 我看 Review / Diff。
7. 我让它做交付检查。
8. 我再从发布场景看一遍。

这 8 句话就是 Codex App 新手最应该先练熟的工作流。

它不炫技，但很稳。

这一课的完整提示词模板

如果你想在自己的项目里复用，可以先发第一段：

请先阅读这个项目，告诉我你看到了哪些文件和文件夹。
请按类别说明每一类文件可能有什么作用。
先不要修改任何文件。

然后从新手读者的角度判断：
1. 当前内容顺序是否适合学习？
2. 哪里缺少解释？
3. 哪里缺少实际截图或必要配图？
4. 哪些内容像作者备注，不适合直接给读者看？

请先只给诊断，不要修改。

等它诊断完，再发第二段：

根据你的诊断，请继续完善这个项目。

目标是：[写清楚你这次要完成什么]
参考材料是：[写清楚它应该看哪些文件或文件夹]
边界是：[写清楚哪些文件可以动，哪些不要动]
交付物是：[写清楚你要正文、清单、图片，还是修改方案]

要求：
1. 只修改和本任务相关的文件。
2. 新增或修改 Markdown 时，要面向读者学习，不要写作者说明。
3. 如果新增图片，请放入 images/，并写回图片目录说明。
4. 如果调整文件顺序，请同步更新 README。
5. 完成后检查图片引用、本地链接和读者视角。

做完后请告诉我：改了哪些文件、新增了哪些图片、做了哪些检查。

这两段模板的核心只有一句：

先诊断，再修改；先读项目，再动手；先看改动，再发布。

这一课的小练习

拿你的练习文件夹，做下面 5 步：

1. 让 Codex 只读扫描项目，先不要修改文件。
2. 让它从新手角度找出 3 个最影响理解的问题。
3. 只挑一个问题，让它先给修改方案。
4. 确认方案后，只允许它改一个文件。
5. 改完后，让它解释 diff，并做图片和链接检查。

这套练习做完，你就不再只是“会问 Codex 一句话”。

你开始学会管理一次小交付。

这一课的检查清单

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

1. 我能先确认当前项目是不是正确文件夹吗？
2. 我会让 Codex 只读扫描，而不是一上来修改吗？
3. 我会要求它从读者角度诊断问题吗？
4. 我能把需求写成目标、材料、边界、交付物吗？
5. 我知道方案太大时要缩小范围吗？
6. 我知道改完后要看 Review / Diff 吗？
7. 我知道看 Diff 时先盯文件数量和改动范围吗？
8. 我会让 Codex 检查图片、链接和作者备注吗？
9. 我知道同一篇教程发到不同平台前要再看一遍吗？

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

这一课的结论

Codex App 当然可以陪你聊天。

它真正有价值的地方，是能围绕一个本地项目连续工作。

但前提是你要会给它节奏：

先读项目，再动手。
先看改动，再发布。
能解释清楚，才算真正完成。

学到这里，你已经跑完了 Codex App 新手阶段最重要的一条路线。

后面再做公众号文章、小红书图文、飞书资料库，都是在这条工作流上继续放大。