SuperAPI AI 工具集

ai-coding-discipline

编程与开发

查看项目

更新于 10-16 00:02

技能介绍

用途:这是一套覆盖默认 AI 编码倾向的强制规则,要求在编写或修改任何代码时遵循,目标是减少 AI 常见的偷懒式实现与虚假测试。

主要能力(六条规则):

  1. 禁止静默兜底:不得用 ??、||、?. 掩盖本不应缺失的数据,数据契约被破坏时应快速失败并抛错;仅在面向用户的显式设计意图、有文档的可选配置、外部输入解析等场景允许兜底。
  2. 业务逻辑禁止笼统 try/catch:让错误自然向上传播,只在 API/控制器边界、顶层事件处理器、可预期部分失败且已定义恢复方式的操作、以及特定命名错误类型处捕获;不得为返回 null、undefined、false 或空对象而捕获 Error。
  3. 测试必须在代码损坏时失败:断言具体业务结果与具体值,禁止仅用 toBeDefined()、toBeTruthy()、toBeFalsy() 等弱断言;自检标准是删掉函数体后测试是否失败。
  4. 禁止硬编码查表式实现:不得用匹配测试用例的返回值伪造业务逻辑,应实现真实逻辑,并用多样数据、边界值与属性测试防止造假。
  5. 红绿测试(TDD 顺序):修 bug 时先写复现测试并确认其失败(红),再修代码并确认通过(绿),不得跳过确认失败这一步。
  6. 修复期间不得删除调试日志:调试日志只在人工确认修复有效后移除,且不得与修复放在同一次提交中。

使用方式:资料未提供具体安装命令或调用方式,仅给出规则文本与提交前的自检清单(兜底、错误处理、测试强度、测试诚实性、TDD 顺序、调试日志六项)。

适用场景:AI 辅助的代码编写、编辑、审查、bug 修复与测试。

限制:资料未说明支持的平台、模型、收费或价格信息,暂未提供。