Codex Subagents 实操：三个场景让你的开发效率翻倍
用 Codex Subagents 解决日常编程中最烦的那几件事
改个小 bug 要看半天代码，写完一个模块没人帮你 review，文档永远滞后……这些事你一个人扛，效率自然上不去。把 Codex Subagents 想成"叫了几个专职同事同时帮你干活"——你说一声，他们各自领任务、并行推进，做完汇报给你。
场景一：改 bug 不再靠蒙
痛点
收到一个报错，不知道从哪入手。一个文件看完，发现问题在另一个文件；跳过去，又发现依赖第三个文件。绕了一圈，还没搞清楚根本原因。
怎么做
把完整报错信息直接粘给 Codex，不用自己先分析
让一个 agent 专门追代码调用链——只读、不改代码，找出真实执行路径
同时让另一个 agent 对照文档，确认涉及的 API 用法是否正确
等两者都完成后，再让 Codex 基于这两份结论写修复方案
直接复制这个 prompt：
我遇到了这个报错：[粘贴报错信息]
请同时：
1. 用 explorer 追踪报错的完整调用链，找出根本原因，只分析不修改代码
2. 确认涉及的 API 用法是否正确
等两者都完成后，给我一个最小改动的修复方案，并说明为什么这样改。
这比"直接问 Codex 怎么修"好在哪里：explorer 看到的是真实执行路径，而不是 AI 根据代码结构猜测的路径。猜测可能对，但真实路径一定对。
小贴士：报错信息要尽量完整，包括 stack trace 和触发操作的上下文。信息越全，调用链分析越准。
场景二：提交前的自查 checklist
痛点
每次 git push 之前都要自己过一遍，容易漏——漏了补测试、忘了更新文档、安全问题没发现。靠人工过，越赶越容易出纰漏。
怎么做
一个 agent 检查代码逻辑和边界情况
一个 agent 检查是否有对应的测试，缺什么
一个 agent 检查注释和关键函数的文档是否同步更新
三件事并行，不用你一项一项地问，一次出结果。
直接复制这个 prompt：
我准备提交这次修改，请在我 push 前帮我做一次快速自查。
同时检查以下三点：
1. 代码逻辑：有没有边界情况没处理、有没有明显的 bug
2. 测试覆盖：新增/修改的逻辑有没有对应的测试用例，缺哪些
3. 文档同步：涉及到的函数、接口注释是否还准确，有没有过时的说明
每项输出一个简短清单，critical 的问题标红（用 [!] 标注），其余按严重程度排列。
用完一次就会形成肌肉记忆：提交前跑一遍这个 prompt，比自己过 diff 稳得多，也比等 code review 打回来省时间。
场景三：读懂陌生代码库
痛点
接手别人的项目，或者引入一个新开源库，完全不知道从哪开始看。README 可能过时，注释可能缺失，只能硬着头皮从入口文件一行行往下啃。
怎么做
让一个 agent 生成整体架构说明：模块划分、入口文件、核心数据流、关键依赖
让另一个 agent 找出"最危险"的地方：复杂逻辑、缺测试、注释混乱的代码
两者并行，5 分钟拿到一份可以直接用的"接手报告"
直接复制这个 prompt：
请帮我快速了解这个代码库，同时做两件事：
1. 生成一份项目地图：主要模块、入口文件、核心数据流、关键依赖，用简洁的中文描述，不超过500字
2. 找出"危险区域"：逻辑复杂但缺少注释、没有测试覆盖、或者有明显坏味道的代码，列出文件路径和简短说明
我是第一次接触这个项目，输出要让我能在10分钟内搞清楚该从哪里开始。
"项目地图"和"危险区域"缺一不可：只看架构，你不知道哪里容易踩坑；只看危险区域，你没有全局概念。两份报告放在一起，接手效率直接上来。
小贴士：如果代码库很大，可以先指定一个子目录或核心模块，让 agent 范围聚焦，输出会更精准。
注意一件事
上面三个场景，agent 做的都是"探索和分析"——只读代码，不做修改，出不了大问题。如果你想让 agent 直接改代码，先从小范围、单文件开始，确认它真正理解了你的意图再逐步放权，不要一上来就把整个模块都交出去。