SuperAPI AI 工具集

architecture-single-responsibility-principle

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

该技能用于审查代码是否符合单一职责原则(SRP),通过多维度检测发现“一个类或方法做得太多”的问题,并给出可执行的修复指引与置信度评分。

主要能力:命名模式分析(如方法名含 and、文件名为 manager/handler/utils 等);规模指标(类超过300行、文件超过500行、方法超过50行、类方法超过15个);依赖分析(构造参数5-8个警告、8个以上严重);复杂度指标(圈复杂度大于10,God 类判定 ATFD>5、WMC>47、TCC<0.33);项目特定模式(领域实体做 I/O、应用服务含业务逻辑、仓储含编排、可选配置参数等)。违规分为 CRITICAL、WARNING、REVIEW 三级,并估算重构工作量。

使用方式:通过 Skill(command: "single-responsibility-principle") 校验收个代码库;可用 --level=fast 做提交前快速检查,--path=src/services/ 指定路径,--format=json 输出给 CI/CD。所需工具包括 mcp__ast-grep__find_code、Read、Bash、Grep、Glob;可选依赖 radon(pip install radon)和 pylint。也可使用 ./scripts/detect-patterns.sh all /path/to/project 运行检测脚本,或指定 method-and、god-class、constructor-params、optional-config 等单个模式。

适用场景:声明重构完成前、代码评审、修改类结构的提交前、实现新服务或处理器之后,以及用户要求检查 SRP 时。

限制:若未安装 radon 则跳过复杂度指标,未安装 pylint 则跳过内聚度指标(TCC、ATFD);分析过慢时可缩小路径或使用 fast 级别;阈值调整可能影响误报率。该技能不提供自动修复,仅给出建议与工作量估算,实际重构需人工或在其他技能配合下完成。安装命令为 uv pip install radon pylint,验证命令为 radon --version 与 pylint --version。