AI Agent / 系统课时
适合 Codex 的开发任务
适合 Codex 的开发任务
Codex 并非只适合“写一个函数”。它更擅长目标清楚、上下文可读取、结果可验证的软件任务。本课会按六类常见工作说明应提供什么信息、怎样设置边界,以及什么样的结果才算真正完成。
学习目标
- 识别适合 Codex 的典型开发任务
- 为不同任务补齐必要上下文
- 用可执行验收条件代替模糊要求
六类高价值任务
| 任务类型 | 应提供的上下文 | 可接受的验收方式 |
|---|---|---|
| 代码理解 | 入口文件、关注模块、业务问题 | 给出调用链、关键状态和证据位置 |
| 功能开发 | 用户行为、接口约束、影响范围 | 新功能可运行,相关测试通过 |
| 缺陷修复 | 复现步骤、错误输出、期望行为 | 缺陷可复现且修复后测试通过 |
| 测试补充 | 风险分支、测试框架、现有约定 | 覆盖目标分支且不过度依赖实现 |
| 重构 | 不变行为、允许调整的边界 | 外部行为不变,结构和验证更清晰 |
| 代码评审 | 比较基线、关注风险、规范 | 按严重度给出可定位、可验证的问题 |
这些任务的共同点是存在可观察结果。只有“把代码变好”这类抽象要求时,Codex 很难判断何时停止,也容易扩大修改范围。
一个可执行的任务描述
下面的任务同时限定目标、范围、约束和验收标准,可直接作为提交给 Codex 的文本。
text
目标:修复订单查询在页码超过总页数时返回 500 的问题。
范围:只修改 order-api 模块,不改变公共响应结构。
约束:兼容现有客户端,不新增第三方依赖。
验收:补充越界页测试;运行该模块测试;说明根因和修改文件。预期结果
text
Codex 定位根因,提交范围受限的代码差异,补充对应测试,并报告测试结果与剩余风险。任务描述不需要预先指定实现细节。把“必须怎样写”改为“哪些行为不能变”,通常能给智能体保留合理探索空间,同时降低偏离业务目标的风险。
不适合直接委派的任务
缺少访问权限、无法复现、没有验收标准的任务不适合直接进入自动修改。例如,仅凭一句“生产偶尔变慢”就要求重写缓存层,证据不足且潜在影响很大。
涉及不可逆数据操作、生产凭证、法律合规或高风险安全决策时,也不应让 Codex独立执行。可以让它整理信息、提出方案或生成演练脚本,但关键动作必须由具备权限的人审核和实施。
把大任务拆成可验证阶段
复杂需求可以先让 Codex探索并提交方案,再单独进入实现。第二阶段只完成最小功能和测试,第三阶段处理重构、文档和扩展场景。
每个阶段都应有独立产物和停止条件。这样即使某一轮判断错误,也能在较小差异中发现问题,而不是到最后才审查一组跨模块改动。
按自己的节奏,确认真正理解。