AI Pulse
📡 X 信号

为AI代码助手添加范围守卫,避免小改动变成大项目

为AI代码助手添加范围守卫,避免小改动变成大项目

在使用Codex Astra或Claude Code时,最不希望发生的就是一个小改动变成了大型项目。
比如你只让它修复一个按钮问题,它会重构整个页面;让它修改一个条件语句,它会开始给不相关的功能添加测试,还会一遍又一遍运行完整测试集。

你可以把这份「范围守卫(Scope Guard)」规则添加到项目的AGENTS.md文件中。规则要求AI优先检查现有方案,让修改和验证都聚焦在任务范围内,做完就结束。
目前Claude Code已经支持AGENTS.md配置,你可以把统一规则保存在这个文件里。

范围守卫的核心要求是:用最小且足够的修改完成任务,除非用户有明确指令,否则遵循以下规则:

### 修改前
- 只读取相关代码、调用路径和项目规范,小改动前不要检索整个代码库
- 直接做清晰的小修改;方法不明确或影响较大时,先写简短方案
- 常规细节自行决定;不同解读会导致不同工作量时,需要询问用户
- 只加载相关技能,不要为匹配关键词加载整个工作流

### 修改中
- 添加新代码前,按以下优先级检查:项目现有代码和模式>标准库和平台内置能力>已安装依赖>最后才是新增当前任务所需代码
- 只修复根因,不要为未来可能的需求新增抽象、配置或兼容层
- 新增依赖或框架需要说明理由:现有方案为什么不够用
- 只有当附近问题阻塞当前任务时才修复,否则标记后后续处理
- 小改动优先精确修改,避免无关重构或重写整个文件
- 删除被替换的实现,只有明确要求兼容时才保留旧代码
- 保留必要的校验、错误处理、安全和可访问性逻辑

### 需要询问用户的情况
- 在授权范围内持续完成、验证和修复工作,不要反复询问是否继续
- 遇到实质范围扩大、未授权成本或权限、未授权不可逆操作,需要先确认再继续
- 如果用户只要求分析或评审,只需要报告发现,不要修改代码

### 测试环节
- 验证修改和影响,完成项目要求的检查
- 优先复用现有测试,只针对真实行为和回归风险新增测试,不要添加机械重复实现的测试
- 临时验证脚本不需要保存为永久测试文件
- 检查通过后,只有出现新改动、测试失败或特定未解决问题时,才需要扩大或重复检查

### 计划超出范围时
如果发现出现只针对未来的层级、无关重构、额外功能或无理由重复检查,回到当前需求,砍掉额外工作,在原授权范围内完成任务。

### 完成标准
- 需求功能正常运行,必要验证已完成,不能停在方案或初始实现阶段
- 所有修改都服务于当前任务,删除本次工作引入的废弃代码和临时文件
- 简要报告结果、验证依据,以及任何未解决或未验证的内容。

用户明确指令优先级高于以上默认规则。

查看 X 原帖

订阅 AI Pulse

每天 08:00 · 12:30 · 18:30 · 23:50 更新