Codex 实战案例

这里不是逐篇复刻外部案例，而是把 Codex 常见实战场景整理成可直接套用的任务模板。

任务模板库

读项目、修 Bug、补测试、重构、文档、CI 和发布前检查

从想法到产品

需求、方案、AGENTS.md、并行开发、集成测试到发布复盘

交付审查

完成任务后如何看 diff、验证结果和剩余风险

案例地图

场景	适合任务	起手提示
文档整理	README、知识库、迁移说明、发布说明	请只读 docs 目录，找出结构重复、链接失效和缺失入口
代码理解	新项目导览、模块说明、调用链	请解释这个项目的主要目录、入口文件和核心流程
小功能开发	新增页面、表单、脚本、配置项	请先给实现计划，确认后再修改
完整产品	MVP、工具、插件、小型 SaaS	请先澄清需求，生成 AGENTS.md，再分阶段实现
测试补齐	单元测试、快照、端到端检查	请找出最适合补测试的函数，并说明测试边界
CI 修复	构建失败、lint 失败、测试失败	请根据错误日志定位最可能原因，不要先改代码
浏览器自动化	页面截图、表单操作、视觉检查	请用浏览器验证页面是否能打开、交互是否正常
知识库自动化	Obsidian、Notion、飞书、文档同步	请先列出读写边界和输出格式
团队规则	AGENTS.md、贡献指南、排障手册	请根据项目结构生成最小可用规则文件

文档整理任务

请检查 docs 目录。
目标：
1. 找出没有入口的页面；
2. 找出可能重复的主题；
3. 找出失效内部链接；
4. 给出重组建议。

限制：
先不要修改文件。

CI 失败修复任务

请分析下面 CI 失败日志。

日志：
【粘贴】

要求：
1. 先判断失败类型；
2. 指出最可能的文件；
3. 给出最小修复方案；
4. 不要做无关重构；
5. 修复后说明需要跑哪些验证。

浏览器验证任务

请验证本地页面：
【URL】

检查：
1. 页面是否正常打开；
2. 导航链接是否可点击；
3. 主要内容是否渲染；
4. 控制台是否有明显错误；
5. 移动端是否有重叠或溢出。

请输出截图观察结果和问题清单。

团队沉淀任务

请基于最近完成的任务，生成团队可复用案例。

输入：
【粘贴任务总结、diff 摘要、测试结果】

输出：
1. 问题背景；
2. 处理步骤；
3. 关键决策；
4. 验证方式；
5. 下次复用模板；
6. 风险和注意事项。