用途:把 14 本经典软件工程书籍提炼成的规则集,直接用于代码评审、重构、设计和技术实现决策,不做语言或框架专属的规则。
主要能力:按任务与书籍的映射加载相应原则,如日常实现与代码评审用 Clean Code、Code Complete;重构用 Refactoring、WELC;架构与依赖管理用 Clean Architecture、APoSD;领域建模用 DDD、DDD Distilled、IDDD;企业应用分层用 PoEAA;生产可靠性用 Release It!;数据一致性与扩展用 DDIA;API 与模块边界用 APoSD;遗留代码与高风险改动用 WELC、Refactoring。另含跨书籍的综合原则,覆盖命名与沟通、函数与例程、架构与边界、数据与状态、测试、错误与失败处理、重构与变更。还有代码评估工作流,包含加载评估框架、阅读仓库与 GitHub 上下文、与已有 issue/PR 去重、按书籍和优先级归类发现、判断是否值得开 issue。
使用方式:通过 skill_view(name='programming-principles', file_path='references/{book-dir}.mini.md') 加载某本书的精简规则;需要完整规则目录时加载 references/{name}.full.md。refactoring-guru.full.md 是索引,会路由到两个分册文件(refactoring-guru.full-smells-and-priorities.md 与 refactoring-guru.full-technique-playbook-and-safety.md),加载索引后按需再加载具体分册。评估流程见 references/code-assessment-workflow.md。兼容性方面:DDD 与 PoEAA 冲突,IDDD 与 PoEAA 冲突,不应作为同等指引加载;Clean Code、Pragmatic Programmer、Code Complete、APoSD 在代码质量上重叠,DDD 系列为不同深度的重叠,Clean Architecture 与 IDDD、PoEAA 在架构分层上重叠,Refactoring 与 Refactoring.Guru 重叠(前者偏策略,后者偏目录)。默认选定一本常驻主书,其余按任务需要加载。
适用场景:代码评审、重构、架构与依赖管理、领域建模、企业应用模式、生产可靠性、数据密集型系统设计、遗留代码安全改动等。
限制:不做语言或框架专属的规则;书籍之间存在冲突或重叠,不能全部等同加载;资料未说明具体价格、平台支持、收费方式或效果数据。