你可以从这些任务开始：
目标：让 Codex 在你的本地项目里完成一个低风险任务。
你需要掌握：
推荐阅读：
]]>目标：让 Codex 在你的本地项目里完成一个低风险任务。
你需要掌握：
推荐阅读：
目标：把 Codex 用在每天的开发工作里，而不是只做演示。
你需要掌握：
推荐阅读：
目标：让 Codex 遵守项目规范，并进入团队的 PR 和评审流程。
你需要掌握：
AGENTS.md。推荐阅读：
目标：把 Codex 变成项目治理和知识沉淀的一部分。
你可以探索：
推荐阅读：
]]>最后核对
官方资料最后核对日期：2026-05-02。安装方式请以 OpenAI Codex CLI Getting Started 和 openai/codex 为准。
最后核对
官方资料最后核对日期：2026-05-02。安装方式请以 OpenAI Codex CLI Getting Started 和 openai/codex 为准。
建议先确认：
git、项目测试命令和包管理器命令。官方 Help Center 当前给出的入门安装方式是：
npm install -g @openai/codex如果你已经安装过，可以先更新：
npm install -g @openai/codex@latest安装后检查版本：
codex --version运行：
codex根据终端提示完成登录。官方资料说明 Codex 可以通过 ChatGPT 账号在多个使用界面中工作，具体可用计划和限制请查看 Codex in ChatGPT Help Center。
进入你的项目根目录：
cd path/to/your/project
codex建议第一次任务只让 Codex 做读取和总结：
请先阅读这个仓库的目录结构、README 和测试配置。不要修改文件。请总结项目用途、主要技术栈、如何运行测试，以及你建议我下一步让你处理的 3 个低风险任务。这样可以确认 Codex 能正常读取项目，也能帮助你了解它对项目的判断质量。
]]>适合新手的任务：
不适合第一次尝试的任务：
适合新手的任务：
不适合第一次尝试的任务：
请修复当前仓库中最小范围的一个测试失败。
要求：
1. 先运行测试，确认失败信息。
2. 阅读相关代码和测试，不要做无关重构。
3. 修改最少必要文件。
4. 修复后重新运行相关测试。
5. 最后总结：失败原因、改了哪些文件、验证命令和剩余风险。重点看四件事：
完成后请自己再看一遍 diff：
git diff如果结果满意，再提交：
git add .
git commit -m "fix: resolve failing test"Codex 可以极大加速你，但最终合并代码的人仍然要对代码负责。
]]>一个稳定的任务说明通常包含：
请处理：[一句话目标]
背景：
- [项目或模块背景]
- [当前问题或期望行为]
范围：
- 可以修改：[文件/目录/模块]
- 不要修改：[明确排除项]
要求：
1. 先阅读相关代码再动手。
2. 保持现有代码风格。
3. 不做无关重构。
4. 修改后运行：[验证命令]
5. 最后说明改动、验证结果和剩余风险。一个稳定的任务说明通常包含：
请处理：[一句话目标]
背景：
- [项目或模块背景]
- [当前问题或期望行为]
范围：
- 可以修改：[文件/目录/模块]
- 不要修改：[明确排除项]
要求：
1. 先阅读相关代码再动手。
2. 保持现有代码风格。
3. 不做无关重构。
4. 修改后运行：[验证命令]
5. 最后说明改动、验证结果和剩余风险。优先说：
少说：
“你看着办”很省字，也很容易把范围交给命运。
把大任务拆成三层：
示例：
请先不要改代码。阅读认证模块、路由和测试，找出把登录页改成双因素登录会影响哪些文件。请输出实施步骤、风险和建议的第一步最小改动。推荐流程：
任务模板：
请修复这个 bug：[描述现象]
已知信息：
- 复现步骤：[步骤]
- 期望结果：[结果]
- 实际结果：[结果]
要求：
1. 先复现或定位失败点。
2. 找到根因后再修改。
3. 保持改动最小。
4. 添加或更新必要测试。
5. 运行相关测试并总结结果。推荐流程：
任务模板：
请修复这个 bug：[描述现象]
已知信息：
- 复现步骤：[步骤]
- 期望结果：[结果]
- 实际结果：[结果]
要求：
1. 先复现或定位失败点。
2. 找到根因后再修改。
3. 保持改动最小。
4. 添加或更新必要测试。
5. 运行相关测试并总结结果。让 Codex 补测试时，关键是说明你想覆盖什么行为，而不是只说“提高覆盖率”。
请为 [模块/函数] 补充测试，覆盖：
- 正常路径：[行为]
- 边界情况：[行为]
- 错误输入：[行为]
不要改生产代码，除非发现当前代码无法测试，并先说明原因。重构任务要先切小。更稳的方式是让 Codex 先做分析：
请阅读 [目录/模块]，找出可以降低复杂度的重构点。先不要修改代码。请按收益、风险和验证成本排序，并推荐第一步最小重构。确认第一步后再实施：
请只执行你刚才建议的第一步重构。保持行为不变，运行现有测试，并说明如何确认没有改变外部行为。Codex 做代码审查时，要让它像 reviewer，而不是像改代码的人。
请审查当前 diff。重点关注：
- 行为回归
- 安全风险
- 并发或状态问题
- 缺失测试
- 命名和可维护性
请按严重程度列出问题，引用文件和行号。不要直接修改代码。适合让 Codex 生成的文档：
注意：生成文档前最好让它先读真实代码和测试，避免写出“看起来很对”的幻觉文档。
]]>AGENTS.md 是给 Codex 这类编码代理看的项目说明文件。它可以描述项目结构、开发命令、测试要求、代码风格和协作边界。
最后核对
AGENTS.md 机制请以 openai/codex GitHub repository 及其文档为准。最后核对日期：2026-05-02。
AGENTS.md 是给 Codex 这类编码代理看的项目说明文件。它可以描述项目结构、开发命令、测试要求、代码风格和协作边界。
最后核对
AGENTS.md 机制请以 openai/codex GitHub repository 及其文档为准。最后核对日期：2026-05-02。
没有项目规则时，Codex 需要从仓库里推断很多事情：
AGENTS.md 能把这些规则显式写下来，减少反复解释。
# AGENTS.md
## 项目概览
- 项目类型：
- 主要语言：
- 关键目录：
## 常用命令
- 安装依赖：`...`
- 本地开发：`...`
- 运行测试：`...`
- 类型检查：`...`
- 格式化：`...`
## 代码规范
- 遵循现有代码风格。
- 不做无关重构。
- 新增功能必须补充或更新测试。
## 安全边界
- 不读取或提交 `.env`、密钥和私有凭据。
- 不执行删除生产数据的命令。
- 修改数据库迁移前先说明影响。
## 交付要求
- 说明改动文件。
- 说明验证命令和结果。
- 说明未验证项和剩余风险。运行测试：pnpm test 比“记得测试”有用。重点不是“信不信任 AI”，而是把风险拆开：
通常可以较快推进：
重点不是“信不信任 AI”，而是把风险拆开：
通常可以较快推进：
建议先确认计划：
请在动手前先说明你计划运行的命令和可能影响的文件。不要读取 `.env`、密钥、token 或任何私有凭据。不要执行删除数据、发布、部署或迁移命令，除非我明确确认。AGENTS.md 写清楚禁止事项。最后核对
OpenAI 官方资料描述 Codex 覆盖 CLI、Web/Cloud、IDE extension 和 App 等使用界面。最后核对日期：2026-05-02。请以 OpenAI Codex 产品页、Codex cloud docs 和 Codex in ChatGPT Help Center 为准。
最后核对
OpenAI 官方资料描述 Codex 覆盖 CLI、Web/Cloud、IDE extension 和 App 等使用界面。最后核对日期：2026-05-02。请以 OpenAI Codex 产品页、Codex cloud docs 和 Codex in ChatGPT Help Center 为准。
适合：
适合：
适合：
使用前建议确认：
适合：
| 任务 | 推荐入口 |
|
Skills 适合固化一类任务的做法，例如：
一个好的 Skill 应该包含：
Skills 适合固化一类任务的做法，例如：
一个好的 Skill 应该包含：
Automations 适合周期性、重复性或需要提醒的任务，例如：
建议沉淀三类内容：
AGENTS.md：项目级规则。recipes/：可复用案例。troubleshooting：失败模式和处理方式。每次 Codex 成功解决一个典型问题，都可以把任务说明、关键步骤和验证命令整理成案例。长期看，这比单次“让 AI 写代码”更有复利。
]]>可能原因：
处理方式：
AGENTS.md。可能原因：
处理方式：
AGENTS.md。处理方式：
处理方式：
处理方式：
处理方式：
最后核对日期：2026-05-02。
最后核对日期：2026-05-02。
请审查当前 git diff。请以代码审查者身份输出发现，不要直接修改文件。
重点关注：
- 可能的行为回归
- 安全或权限风险
- 错误处理遗漏
- 并发、缓存、状态同步问题
- 缺失测试
- 与现有代码风格不一致的地方
输出要求：
1. 按严重程度排序。
2. 每条问题引用文件和行号。
3. 说明为什么这是问题。
4. 给出最小修复建议。
5. 如果没有发现问题，也请说明仍然建议人工检查的点。请审查当前 git diff。请以代码审查者身份输出发现，不要直接修改文件。
重点关注：
- 可能的行为回归
- 安全或权限风险
- 错误处理遗漏
- 并发、缓存、状态同步问题
- 缺失测试
- 与现有代码风格不一致的地方
输出要求：
1. 按严重程度排序。
2. 每条问题引用文件和行号。
3. 说明为什么这是问题。
4. 给出最小修复建议。
5. 如果没有发现问题，也请说明仍然建议人工检查的点。审查结束后，不要让它一次性修所有问题。选择一条高优先级问题：
请只修复审查结果中的第 1 条问题。保持改动最小，补充必要测试，并运行相关验证命令。Codex 审查不能替代团队 review。它适合提高信噪比，但合并前仍要由熟悉业务的人确认需求、兼容性和上线风险。
]]>请修复当前仓库中的测试失败。
要求：
1. 先运行测试命令，记录失败信息。
2. 根据失败信息阅读相关测试和实现代码。
3. 找到根因后再修改，不要做无关重构。
4. 修改最少必要文件。
5. 修复后重新运行失败相关的测试。
6. 最后总结根因、改动文件、验证命令和剩余风险。请修复当前仓库中的测试失败。
要求：
1. 先运行测试命令，记录失败信息。
2. 根据失败信息阅读相关测试和实现代码。
3. 找到根因后再修改，不要做无关重构。
4. 修改最少必要文件。
5. 修复后重新运行失败相关的测试。
6. 最后总结根因、改动文件、验证命令和剩余风险。如果它只改测试：
请解释为什么应该修改测试而不是实现。这个测试原本表达的业务期望是什么？有没有官方需求、README 或其他测试可以佐证？如果它跑不通测试：
请区分当前失败是环境问题、依赖问题还是代码问题。不要继续改业务代码，先给出阻塞原因和可执行的修复建议。每个案例建议包含：
每个案例建议包含：
AGENTS.md。