用途:这是一套 AI 辅助开发的技术决策标准与反模式集,用于在修复缺陷、代码审查、实现变更时约束行为,强调价值优先、根因治理与质量门禁。
主要能力:列出代码质量与设计反模式(如三次以上重复、单文件职责混杂、多处维护同一运行时规则、注释屏蔽代码、压制错误、绕过类型或校验等安全机制、临时凑合、补丁式实现、症状式修复、未规划的大规模改动),发现即需立即停下复核设计。提供 Fail-Fast 回退设计原则:错误须显式且可追踪,禁止无条件默认值回退,回退须有设计文档批准、记录业务理由、记录日志并加监控;基础设施层向上抛错,应用层做业务决策。给出 Rule of Three 的重复代码处理标准及应共化与避免共化的情形。要求实现前先排查现有代码:找到相似功能时校验其是否满足需求且具备仓库代表性,再复用或扩展。提供质量检查流程:静态分析、构建验证、测试、最终质量门禁四阶段,并需先通过受影响文件类型、清单、配置与 CI 发现适用的质量工具及领域校验器。还规定影响分析三阶段(发现、理解、识别)与结构化报告,以及未使用代码删除、现有代码修改的判定路径。
使用方式:官方资料未给出安装命令或调用方式,暂未提供。内容以规则与流程形式给出,并提到任务文件中的 Quality Assurance Mechanisms、Design Doc、ADR 等配套概念;前端反模式、调试与质量检查另见 references/frontend.md。
适用场景:修复 bug、审查代码、实现变更等需保证正确性与可维护性的开发任务。
限制:规则为强制性流程要求,具体工具、阈值、命令、平台支持与收费方式在资料中暂未提供。