AI Agent / 系统课时
拆分复杂开发任务
拆分复杂开发任务
复杂需求如果一次性要求 Codex“全部做完”,最容易出现范围漂移、错误叠加和验收困难。更稳妥的方法是把任务拆成可独立确认的阶段,让每一阶段都有明确输入、产物和停止条件,再逐步推进到最终结果。
学习目标
- 能按不确定性和验收边界拆分大型开发任务,而不是机械按文件拆分
- 能为分析、实施、验证和收尾阶段定义清晰的完成条件
- 能写出允许 Codex 连续推进、又能在关键节点及时止损的阶段化指令
按可确认结果划分阶段
任务拆分的核心不是“分得越细越好”,而是让每一步都能回答一个明确问题。分析阶段先确定现状与影响范围;实施阶段只完成已确认的变更;验证阶段用测试、类型检查或构建证明行为;收尾阶段再处理文档、清理和最终差异。

给每个阶段定义入口和出口
一个可执行的阶段至少要写清目标、允许范围、产物和验证方式。对同一个需求,可以这样组织:
| 阶段 | 主要问题 | 可验收结果 |
|---|---|---|
| 分析 | 现状在哪里,哪些模块会受影响 | 方案、涉及文件、风险与待确认点 |
| 实施 | 最小改动怎样落地 | 只包含本阶段目标的代码差异 |
| 验证 | 如何证明行为正确且无明显回归 | 指定测试、类型检查或构建结果 |
| 收尾 | 是否还有临时改动和说明缺口 | 干净 diff、必要文档与变更说明 |
阶段之间最重要的是“出口条件”。例如分析阶段如果还无法确定数据模型,就不应直接进入编码;验证阶段发现失败,也应先定位根因,而不是顺手继续加功能。
用一段指令串起阶段
片段示例:下面不是 Shell 命令,而是一段可直接发送给 Codex 的任务指令。假设仓库已有订单查询接口和可运行的测试脚本。
text
目标:为订单查询接口增加按状态过滤,同时保持原有分页行为不变。
阶段 1:分析
- 只阅读相关实现和测试,不修改文件。
- 找出请求参数解析、查询条件构造和现有分页测试所在位置。
- 输出建议方案、受影响文件和风险;如果现有行为不明确,先停止并说明问题。
阶段 2:实施
- 只实现 status 过滤及对应测试,不做无关重构。
- 保持未传 status 时的现有行为。
阶段 3:验证
- 运行与订单查询相关的现有测试。
- 再运行项目已有的类型检查或构建检查。
- 如果失败,先说明失败原因并修复本次改动造成的问题。
阶段 4:收尾
- 检查最终 diff,删除临时日志或调试代码。
- 报告修改文件、验证结果和仍未解决的风险。这段指令没有要求每个阶段都向用户重新询问,而是把“什么时候继续、什么时候停止”写进任务本身。这样既能保持连续推进,又能防止在关键前提不成立时继续扩大错误。
控制阶段大小而不是追求固定模板
适合独立成阶段的通常是高不确定性、高风险或需要单独验证的部分,例如数据库迁移、接口兼容性、权限变化和跨模块重构。相反,一个只改一处条件判断并已有稳定测试的小任务,可以把实施与验证放在同一阶段,不必人为制造流程成本。
判断拆分是否合理,可以问两个问题:某一步做错后,能否在进入下一步前发现;某一步完成后,是否能用具体证据确认。只要答案都为“能”,阶段边界就有价值。复杂任务因此不是被切成更多文字,而是被切成一连串可验证、可回退、可继续推进的工作单元。
按自己的节奏,确认真正理解。