用途:为编写可长期维护、可扩展的代码提供工程纪律约束,避免临时修补变成长期技术债。
主要能力:包含三类核心规则(不走捷径、最小改动、完成前验证)以及质量门禁清单。质量门禁覆盖代码(无错误与警告、遵循既有模式、无硬编码值、有错误处理、边界处做输入校验)、测试(逻辑用单元测试、流程用集成测试、覆盖边界情况、测试确定性)、性能(避免 N+1、合理缓存、资源清理)、安全(输入清洗、鉴权与授权检查、代码中无密钥)。
决策规则:何时重构——当添加功能痛苦、缺陷级联、代码令人困惑时;不重构——代码可用且很少改动、无即时需求时。何时抽象——同一模式出现 3 次以上、抽象能降低复杂度时;不抽象——仅出现 1 至 2 次、抽象反而更复杂时。还列出反模式及改进方向:魔数改用命名常量、上帝对象改为单一职责、复制粘贴改为抽取共享、注释掉的代码改用 Git 历史、过早优化改为先测量。
使用方式:作为编码与提交时的检查准则,强调每次提交只做一处逻辑改动、只触碰必要部分、优先编辑而非重写以保留上下文,并在标记完成前逐项通过质量门禁。
适用场景:需要长期维护、可能扩展到大规模用户量的代码库开发与评审。
限制:资料未说明具体安装命令、平台支持、收费方式或自动化执行方式,均暂未提供。