为自主 AI 编码 Agent 重新设计代码库
pre-commit 里开发者跑 just test,CI 却在 YAML 里枚举自定义 shell 步骤——这些清单必然漂移。对 AI agent 来说,这种漂移是致命的。
核心要点
- 清单漂移是真实存在的:审计发现,二级 CI 清单悄悄丢掉了 mise run build。
- 更夸张的例子:一个 Cookiecutter 模板的烘焙测试执行了每一个生成的任务,唯独漏了 pytest——发布了一个自己的 CI 从没跑过测试套件的模板。
- 为什么对 agent 致命:agent 依赖反馈循环。如果它跑的 test 和 CI 跑的不是同一套,它学到的就是错的。
- 解法:统一任务入口(一个命令跑所有检查),消除多处维护。
◇ 对你的项目意味着什么
接 AI 编码 agent 之前,先做一次「任务入口一致性」审计。如果本地、pre-commit、CI 跑的不是同一套命令,agent 会一直学到错的反馈。