4.2 Codex 任务模板库
前面讲的是 Codex 的标准工作流。
这一节直接放一些常用模板，方便以后复制使用。
这些模板的作用是：
不用每次重新想 Prompt，直接按场景复制，然后填入自己的需求。
读项目模板
这个模板适合在刚打开一个新项目时使用。
尤其是你第一次让 Codex 接触某个项目，不要一上来就让它改代码。
更稳的方式是：先让它读项目，输出一份项目理解报告。
这样你可以先判断：
| 检查点 | 作用 |
|---|---|
| Codex 是否看懂项目 | 防止一上来改错文件 |
| 技术栈是否判断正确 | 确认它知道项目用的是什么框架 |
| 启动方式是否清楚 | 后面测试和运行更顺 |
| 核心模块是否找对 | 后续修改不会乱找方向 |
| 风险是否提前暴露 | 避免误改核心逻辑 |
读项目模板（可直接复制）
请先不要修改任何代码。请阅读当前项目，并输出一份项目理解报告，包括：
1. 技术栈 – 项目使用了哪些主要技术 – 前端/后端/数据库/构建工具分别是什么 – 是否使用 TypeScript、Tailwind、框架或组件库
2. 目录结构 – 主要目录分别负责什么 – 页面、组件、工具函数、接口、配置文件分别在哪里 – 哪些目录是核心目录，哪些目录不建议随便改
3. 启动方式 – 项目如何安装依赖 – 项目如何本地启动 – 是否需要环境变量 – 如果 README 里有说明，请优先参考 README
4. 测试命令 – 项目是否有 test 命令 – 是否有 lint 命令 – 是否有 typecheck 命令 – 是否有 build 命令 – 如果没有相关命令，请明确说明
5. 核心模块 – 项目的核心功能模块有哪些 – 每个模块大概负责什么 – 如果后续要修改功能，应该优先查看哪些文件
6. 后续修改风险 – 哪些文件或目录改动风险较高 – 哪些逻辑不能随便改 – 是否存在全局样式、全局配置、鉴权、接口、数据库等高风险区域 – 后续修改时需要特别注意什么
请只输出项目理解报告，不要修改代码。 输出完成后等待我确认。
修 Bug 模板
我遇到一个 bug：
– 【现象】 – 【复现步骤】 – 【期望结果】 – 【实际结果】 – 【相关文件/页面】
请先定位原因，不要直接修改。
先给出：
1. 可能原因 2. 需要查看的文件 3. 修复方案 4. 风险点 等我确认后再改代码。
加功能模板
我想新增一个功能：
– 【功能描述】 – 【入口位置】 – 【交互流程】 – 【视觉要求】 – 【数据来源】 – 【验收标准】
请先阅读相关代码，给出实现计划。
不要改无关文件。
实现后请运行测试并总结 diff。
前端页面模板
请根据下面要求实现一个页面：
– 【页面用途】 – 【目标用户】 – 【视觉风格】 – 【模块结构】 – 【中文文案】 – 【响应式要求】 – 【不要出现的问题】
请先给出组件拆分方案，再开始实现。
代码审查模板
请审查当前分支相对 main 的 diff。
重点检查：
1. 潜在 bug 2. 边界条件 3. 安全风险 4. 类型问题 5. 性能问题 6. 是否有无关修改 7. 测试是否充分 请不要直接修改代码，先输出 review 报告。
重构模板
请重构以下模块：
【模块路径】
目标是：
1. 提高可读性 2. 减少重复代码 3. 保持现有行为不变 4. 不改变公共 API 5. 不引入新依赖 请先写重构计划，并说明如何验证行为一致。
写测试模板
请为以下功能补充测试：
要求：
1. 不改业务逻辑 2. 覆盖正常路径 3. 覆盖异常路径 4. 覆盖边界条件 5. 运行测试并报告结果。
写文档模板
请根据当前项目生成文档：
1. 项目简介 2. 安装方式 3. 启动方式 4. 环境变量说明 5. 常用命令 6. 目录结构 7. 开发注意事项 8. 常见问题 请不要编造不存在的命令，必须基于项目文件判断。
💎 【独家资源】火儿跨境科技 VIP 资料会员：
解锁全站 500+ 实战提示词库、自动化工作流脚本、商业源码与高阶专属圈子，持续沉淀一人公司数字资产。
👉 立即开通 VIP 资料会员（月度订阅 $9.99，即刻畅享核心工具箱） | 查看会员权益与等级说明
🚀 【体系大课】火儿跨境科技 官方实战课程：
告别零散摸索，全案拆解从建站、SEO长效获客到海外广告变现的工业级闭环流水线。
👉 《谷歌SEO优化系统课程》 | 《谷歌广告全系统基础夯实课》 | 《Facebook广告投放基础夯实课》 | 查看全部实战课程专区
💡 进阶指引：本文属于《03Codex从入门到实战》系统实操专栏。如需全面掌握从零构建智能体协作开发环境与自动化工程流水线，欢迎查阅对应大盘母舰专题：AI智能体团队协同。
