clean-code
这是一份基于 Robert C. Martin(Uncle Bob)《Clean Code:敏捷软件开发实践指南》的软件工艺规则集,并在原 2008 年建议已被更新的地方做了现代修正。共收录 48 条规则,分为 10 个类别,并按影响程度优先级排序,用于指导代码评审、重构决策和新代码开发。示例以 Java 为主,但原则与语言无关。适用时机包括:编写新的函数、类或模块;为变量、函数、类或文件命名;评审代码可维护性问题;重构既有代码以提升清晰度;编写或改进单元测试;封装第三方依赖。类别按优先级依次为:命名(CRITICAL)、函数(CRITICAL)、注释(HIGH)、格式(HIGH)、错误处理(HIGH)、对象与数据结构(MEDIUM-HIGH)、边界(MEDIUM-HIGH)、类与系统(MEDIUM-HIGH)、单元测试(MEDIUM)、浮现式与简单设计(MEDIUM)。文档入口提供各参考文件:章节定义、规则模板、metadata.json 等。