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 可能选择修改接口,让实现更简单,但破坏已有调用方。

因此,在任务描述中应优先声明稳定资产,例如公开接口、数据格式和核心流程。

修改后的验证流程

限制范围并不代表可以跳过检查。完成修改后,仍需要验证实际变更是否符合预期。建议检查:

  • 是否只修改了允许文件。
  • 是否保持原有接口行为。
  • 是否新增了不必要依赖。
  • 是否覆盖关键测试场景。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

限定修改范围与文件边界

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

登录哪都通