用途:检测代码是否符合单一职责原则(SRP),采用演员驱动(actor-driven)分析,识别一个类或方法服务多个变更发起方的情况,适用于代码审查、重构与架构评审前的违规发现。
主要能力:提供 fast、thorough、full 三档校验。fast 约 5 秒,仅查方法名含 and 等命名模式;thorough 约 30 秒,增加类与方法规模、内聚度指标和构造参数分析;full 约 5 分钟,含演员分析引导问答。可用指标包括行数、方法数、构造参数数、ATFD、WMC、TCC,并可结合 radon 计算复杂度,输出文本或 JSON 报告、置信度与重构工时估算。支持通过 CLAUDE.md 检测项目特定反模式。
使用方式:调用 Skill(command: "validate-srp"),可传 --path、--level、--output_format、--threshold 等参数;也可运行 ./scripts/validate-srp.sh <path> --level=fast|thorough|full,或用 ./scripts/check-god-class.sh <file.py> 单文件检测,并可与 code-review、validate-architecture、quality-gates 等技能集成。
适用场景:提交前快速扫描、类级审查、上帝类识别、跨层架构边界检查及重构规划。
限制:各项阈值(如类超 300 行、方法超 50 行、ATFD>5 且 WMC>47 且 TCC<0.33 判定上帝类)为启发式判断,命名模式类违规置信度约 40%,存在误报可能;完整分析及自动修复需人工确认;实际效果、性能与安装依赖以官方资料为准,部分内容暂未提供。