用 Codex 完成常见开发任务
一套通用的 Codex 工作流
不管你是在 CLI、IDE 扩展还是 App 里工作，都建议保持同一个基本节奏：
- 先给上下文，不要只丢一句模糊需求。
- 先让 Codex 说计划，再动代码。
- 一次只做一个清晰目标，不要把 10 个需求塞进一条消息。
- 每做完一步就运行、验证、看 diff。
- 对复杂任务优先用
Worktree或Cloud，而不是直接在主工作区硬改。
场景 1：从需求文档到首版原型
适用章节：
推荐提示词：
text
请根据当前打开的需求文档，帮我实现一个首版原型。
要求：
1. 先输出页面树、组件拆分和主流程
2. 等我确认后再创建文件
3. 优先做首页、主流程页、结果页
4. 使用假数据，不接真实 API
5. 每完成一轮后运行项目并告诉我入口地址如果你在 IDE 扩展里工作，优先把 PRD.md、页面草图或关键截图一起放进上下文，不要让 Codex 凭空猜。
场景 2：给原型接入 AI API
适用章节：
推荐提示词：
text
请帮我把当前原型中的“生成内容”按钮接成真实 API。
要求：
1. 不要把 API Key 硬编码进代码
2. 创建环境变量占位和 README 说明
3. 先梳理前端调用链路，再创建请求封装
4. 补上 loading、empty、error 三种状态
5. 最后运行项目并给我一个最小测试步骤如果你准备把这一步交给学员或团队，建议额外要求：
- 生成一个
测试提示词列表 - 生成一个
常见报错排查表
场景 3：Clone 并跑通一个开源项目
适用章节：
推荐提示词：
text
请帮我接手这个 GitHub 项目并把它跑起来：
[仓库链接]
要求：
1. 先 clone 到当前目录
2. 识别技术栈和启动命令
3. 安装依赖并启动开发服务
4. 如果失败，自己先排查一次
5. 最后告诉我本地访问地址和仍然存在的问题如果这是课程演示项目，建议优先用 Worktree 模式启动，避免把你当前主分支弄脏。
场景 4：部署到 Zeabur 或其它平台
适用章节：
推荐提示词：
text
请帮我把当前项目整理成可部署版本。
要求：
1. 识别这是静态站点、Node 服务，还是前端构建项目
2. 检查端口、构建命令和输出目录
3. 如果平台要求监听 8080，请修改到兼容方式
4. 生成一份部署检查清单
5. 不要自动删除任何现有文件这类任务特别适合在 Codex App 里做，因为你通常需要同时看：
- 配置文件
- 构建日志
- diff
- 最终提交内容
场景 5：代码审查、Diff 跟进与补改
Codex App 的 Git 视图适合做这类工作：
- 先看 diff，不急着让 Codex 继续写。
- 针对某个 chunk 加批注，让它只改这一处。
- 修完后再让它总结本轮改动。
- 最后再 commit / push / 开 PR。
推荐提示词：
text
请只审查当前 diff，不要查看整个仓库。
重点看：
1. 行为回归
2. 错误处理
3. 测试缺口
先列问题，再决定是否修改场景 6：多任务并行与长任务委派
当你遇到下面这些情况时，可以优先考虑多线程或子代理：
- 一个 PR 需要同时看安全性、可维护性、测试覆盖
- 一个新功能要同时做“实现、测试、文档”
- 一个大仓库需要先并行探索多个目录
推荐做法：
- 先主线程定义目标和验收标准
- 再让 Codex 把任务拆成 2 到 4 个并行工作
- 最后回到主线程统一汇总结果
本站教程的 Codex 对应关系
| 原教程章节 | 你最适合怎么用 Codex |
|---|---|
| 学会 AI 编程工具 | 用 IDE 扩展或 CLI 完成第一个小游戏 / 网页 |
| 动手做出原型 | 用 Codex 从需求文档先产出页面树，再生成原型 |
| 给原型加上 AI 能力 | 用 Codex 接 API、补状态、跑测试 |
| Supabase 数据库实战 | 用 Codex clone、启动项目并连接数据库 |
| Zeabur 部署 | 用 Codex 检查端口、构建命令和部署配置 |
| 设计稿转代码 | 用 Codex + MCP 读取设计结构并生成代码 |