用途:这是一份给 AI 编程代理使用的检查清单,适用于代理正在编写或重构生产代码、需要抑制其已知失败模式的场景。
主要能力:以十条规则约束代理行为。包括:写代码前先读两三个相邻文件,沿用项目既有的模式、命名、错误处理与注释密度;只做能解决问题的最小改动,不做投机性抽象、不加没人要求的配置项、不顺手重写,重构与行为变更分开提交;不得编造 API,看不到函数签名就先 grep;宣称完成前必须实际运行构建、测试、接口或页面,未运行就标注“untested”;不得通过删除断言、放宽匹配、加 skip 或特判测试输入来让测试通过;不得吞掉错误,禁止空 catch 块、except: pass 或返回默认值掩盖失败;改代码前先读错误与堆栈;不越出请求范围,发现的无关 bug 只提一句不打包进 diff;删除或覆盖前先确认调用方并阅读文件;不打印、提交或复制密钥令牌,不硬编码凭据,使用项目已有的环境变量。
使用方式:在提交 diff 前逐条核对清单,凡不能回答“是”的项,需在总结中作为已知限制写明。汇报时用一两句话说明改了什么、如何验证、哪些未验证,不复述用户已能读到的 diff,也不表达未经验证的信心。
适用场景:AI 代理参与生产代码编写、重构、修 bug 的流程,以及需要人工审查代理产出的团队。
限制:资料未提供具体安装命令、平台支持、收费方式或与其他工具的集成细节。