diff --git a/AGENTS.md b/AGENTS.md index 7714d901..4fe3d7ed 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -141,7 +141,7 @@ ## 4) 代码修改约定(实用版) -- **最小改动原则**:只改与需求直接相关文件,避免顺手重构。 +- **根治优先原则**:修复问题时优先判断能否根治;能根治的,应告知用户根治方案与影响范围并询问是否执行,在一定范围内的重构是可接受的,尽可能避免打补丁式的临时修改。 - **精确读取原则**:禁止整文件通读。阅读/修改前先用搜索工具(grep / 符号查找 / 关键字定位)锁定需要的行段,只精确提取并阅读相关片段,不要把整个文件一次性读进来。 - **文件编辑方式**:修改文件时优先使用 `apply_patch` 或其他原生文件编辑工具;尽量不要用 `bash`/`python` 脚本批量改文件,除非原生工具明显不适合。 - **后端改动优先级**:先改 `modules/`、`server/` 内对应模块,最后才动入口。