AI Agent / 系统课时
限定修改范围与文件边界
限定修改范围与文件边界
AI 修改项目时,最大的风险不是不会生成代码,而是在不了解约束时修改了不应该触碰的部分。通过明确文件边界、接口约束和兼容要求,可以让 AI 在指定范围内完成安全迭代。
学习目标
- 掌握限制 AI 修改范围的方法。
- 理解文件边界和接口约束的重要性。
- 学会编写可执行的修改规则。
为什么需要限制修改范围
大型项目通常包含多个模块,不同文件承担不同职责。如果 AI 可以自由修改整个代码库,可能会为了完成当前任务调整无关代码,导致隐藏风险。
限定范围的本质是给 AI 建立工作边界,让它知道哪些内容可以变化,哪些内容必须保持稳定。常见约束包括:
- 允许修改的文件列表。
- 禁止修改的公共接口。
- 必须保持的兼容行为。
- 需要优先复用的已有逻辑。
使用边界清单描述任务
在向 AI 提交修改任务时,可以先提供边界说明,让模型根据约束规划修改方案。
yaml
# 片段示例:修改任务边界说明
change_scope:
allowed_files:
- "src/auth/login.ts"
- "src/auth/types.ts"
forbidden:
- "public API 参数格式"
- "数据库表结构"
requirements:
- "保持旧调用方式可用"
- "新增逻辑需要提供测试"这种方式比简单描述功能更加稳定,因为 AI 可以同时理解目标和限制条件。
文件边界与接口兼容
文件边界解决“改哪里”的问题,接口约束解决“不能改变什么”的问题。两者结合后,AI 的修改空间会明显收窄。
例如,一个新增功能可能只允许增加内部实现,而不能改变已有函数参数。如果没有明确说明,AI 可能选择修改接口,让实现更简单,但破坏已有调用方。
因此,在任务描述中应优先声明稳定资产,例如公开接口、数据格式和核心流程。
修改后的验证流程
限制范围并不代表可以跳过检查。完成修改后,仍需要验证实际变更是否符合预期。建议检查:
- 是否只修改了允许文件。
- 是否保持原有接口行为。
- 是否新增了不必要依赖。
- 是否覆盖关键测试场景。
按自己的节奏,确认真正理解。