用途:该技能在编写、修复、编辑、审查或重构任何 Python 代码时启用,用于按 Robert C. Martin《Clean Code》第17章的完整规则目录约束代码质量。
主要能力:按类别组织规则。注释类(C1-C5)禁止元数据注释、冗余注释与注释掉的代码,过时注释须立即删除。环境类(E1-E2)要求一条命令构建(pip install -e ".[dev]")和一条命令测试(pytest)。函数类(F1-F4)限制最多 3 个参数(更多时用 dataclass)、禁止输出参数与标志参数、删除死函数。通用类(G1-G36)覆盖 DRY、一致的抽象层级、最小化公共接口、删除死代码、变量靠近使用处、避免特性依恋与选择器参数、优先多态而非 if/else、使用命名常量替代魔法数字、函数只做一件事、封装边界条件、迪米特法则等。Python 专属(P1-P3)适配 PEP 8:禁止通配符导入、使用 Enum 而非魔法常量、公共接口加类型提示。命名类(N1-N7)要求描述性、无歧义、长度匹配作用域的命名。测试类(T1-T9)要求覆盖可能出错的代码、使用覆盖率工具、测试边界条件、测试须快(每条 <100ms)。
使用方式:审查代码时按规则编号指出违规(如“G5 违规:逻辑重复”);修复或编辑代码时报告所修内容(如“已修复:将魔法数字提取为 SECONDS_PER_DAY(G25)”)。文档附带速查表与反模式对照(Don't → Do)。
适用场景:Python 项目的日常开发、代码评审与重构。
限制:规则为规范性指导,资料未提供自动执行细节、工具集成方式或强制手段;部分细节暂未提供。