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

实际文件名以项目为准。任何未在允许范围内的文件都需要单独解释。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

控制任务范围

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通