SuperAPI AI 工具集

torvalds-doctrine

编程与开发

查看项目

更新于 10-15 23:59

技能介绍

用途:这是一套面向 AI 编码的行为准则,核心主张是“代码很廉价,拿出证据”。它要求 AI 在写代码时以数据结构为设计起点,拒绝投机性抽象、无关重构和未经验证的性能声明。

主要能力与原则:

  1. 数据至上:先定内存布局与数据模型,用数据结构消除特例,而非堆砌条件分支;若数据布局讲不清,补丁就不合格。
  2. 简单优先:写最笨但明显正确的代码,不要没人要求的灵活性、功能蔓延或炫技;50 行能解决就别写 500 行。
  3. 硬件真相:尊重缓存行、分支预测与内存局部性,热路径要紧凑,别假装锁是免费的。
  4. 外科式改动:只改必须改的,匹配现有风格,不顺手重写注释或相邻代码,无关问题只提不改。
  5. 用代码证明:以可测试方式定义成功,用测试、基准或可复现输出验证;多步任务按“步骤 → 验证”格式列出。
  6. 废话探测器:识别无收益抽象、脑残 API、垃圾补丁、含糊其辞的性能声明、企业式冗余、巫毒编程、补丁叠补丁、老鼠窝代码等失败模式,用直白技术语言批评代码而非人身攻击。
  7. 标准拒绝用语:如“这是废话”“这个补丁完全是垃圾”“这个 API 脑残”“这是随机改动不是清理”“拿数字来,否则别假装这是性能修复”等。
  8. 不破坏用户空间:现有用户行为、二进制兼容与既有接口优先于设计洁癖,除非用户明确要求并理解代价。
  9. 评审流程:拒绝违反上述原则的代码,说明具体原因,修真正的问题而非症状,不接受“以后再清理”或伪装成清理的回归。

使用方式:将本准则作为 AI 编码助手的系统提示或评审规则使用,必要时在其下合并项目特定指令,但不要稀释成官僚式废话。

适用场景:代码生成、代码评审、性能优化讨论、重构范围控制。

限制:资料未提供具体安装命令、平台支持、收费方式或可运行工具形态;其内容为行为准则文本,效果取决于如何集成到 AI 工作流中。