用途:这是一套强制生效的编码纪律规则,用于约束 AI 在编写、编辑、审查、修复与测试代码时的默认倾向,减少常见反模式。适用于所有代码改动场景。
主要能力(共 6 条规则): 规则1「禁止静默回退」:不要用回退值掩盖本不应缺失的数据;写 ??、||、?. 前先自问该值是否可能合法为空、回退后下游结果是否正确、抛错是否更利于定位 bug,若最后一项为是则抛错。仅当面向用户展示且是明确设计意图、有文档的可选配置默认值、外部输入解析(缺失为合法状态)时才允许回退。 规则2「业务逻辑禁止全包 try/catch」:业务函数不应包裹全部逻辑,应让错误自然向上传播,只在 API/控制器边界、顶层事件处理器、定义了恢复策略的部分失败操作、以及特定具名错误类型处捕获;不要为了让调用方拿到 null、undefined、false 或空对象而捕获 Error。 规则3「测试必须在代码损坏时失败」:每个测试验证具体业务结果,断言具体数值而非仅存在性;自检方式为删除函数体后测试是否仍通过。禁止将 toBeDefined()、toBeTruthy()、toBeFalsy() 等弱断言作为唯一断言。 规则4「禁止硬编码查表实现」:不得通过硬编码匹配测试用例的返回值来实现逻辑,应写真实逻辑,并用多样化数据、边界值与规格外取值防查表造假。 规则5「红-绿测试(TDD 顺序)」:修 bug 时先写可复现的失败测试并确认其为红,再修复代码并确认转绿;不可跳过看红这一步。 规则6「修复期间不得删除调试日志」:调试日志只应在人工确认修复有效后移除,且不得与修复放在同一次改动中。
使用方式:作为编码时加载的规则集,在提交任何代码前按自检清单核查回退值、异常处理、测试强度、测试真实性、TDD 顺序与调试日志六项,任一为「是」需修改后再继续。
限制与缺失:资料未提供安装命令、具体平台支持、收费方式与版本信息,暂未提供。