AI Agent / 系统课时
控制任务范围
控制任务范围
没有范围边界的请求容易演变成跨模块重构。本课将通过允许修改、禁止触碰和保持不变三类约束,把 Codex 的工作限制在完成目标所需的最小区域。
学习目标
- 明确允许修改的模块与文件
- 保护不相关接口、数据和生成文件
- 识别何时应先请求扩展范围
三层范围边界
“允许修改”定义主要工作区,例如某个服务和对应测试。“禁止触碰”保护迁移脚本、生成代码、锁文件、公共协议或生产配置。“保持不变”则描述行为兼容性,例如现有响应字段、排序规则和错误码不能变化。
文件边界和行为边界应同时存在。只限制文件可能迫使 Codex 在错误位置硬塞逻辑;只限制行为又可能导致它修改过多文件。最好的范围允许必要实现,同时要求超出范围前先说明理由。
编写范围受控的任务
下面的指令要求 Codex 修改订单导出功能,但禁止顺手重构共享组件。
text
目标:
在订单 CSV 导出中增加 paymentMethod 列。
允许修改:
- src/orders/export/**
- tests/orders/export/**
- 仅在确有必要时修改 src/orders/OrderDto.ts
禁止修改:
- 数据库迁移与表结构
- src/shared/csv/**
- package-lock.json
- 任何生产环境配置
必须保持不变:
- 现有列的名称、顺序和格式
- 默认时间范围与权限校验
- 现有 API 路径和响应状态码
边界处理:
如果必须修改允许范围之外的文件,先停止并说明原因、候选文件和最小改动,不要直接实施。
验收:
更新测试,运行相关测试与静态检查,并列出全部修改文件。预期结果
text
Codex 只在导出模块和测试中增加新列;若发现共享 CSV 组件必须调整,会先提出范围扩展请求,而不是直接改动。不要把范围锁得过死
范围控制不是预先指定每一行实现。如果你只允许修改一个明显不负责该行为的文件,Codex 可能被迫复制逻辑或破坏架构。可以使用“优先修改”与“需要扩展时先报告”的组合,保留合理决策空间。
对于陌生仓库,先让 Codex 只读分析最小影响面,再确定允许范围。分析阶段与实施阶段分开,通常比一开始猜文件更可靠。
审查是否越界
任务完成后,用 git status --short 和 git diff --name-only 核对文件清单。发现锁文件、格式化文件或无关模块变化时,先确认是否由命令自动产生,再决定保留还是回退。
bash
git status --short
git diff --name-only预期输出
text
M src/orders/export/OrderCsvExporter.ts
M tests/orders/export/OrderCsvExporter.test.ts
src/orders/export/OrderCsvExporter.ts
tests/orders/export/OrderCsvExporter.test.ts实际文件名以项目为准。任何未在允许范围内的文件都需要单独解释。
按自己的节奏,确认真正理解。