SuperAPI AI 工具集

code-smell-detector

编程与开发

查看项目

更新于 10-15 23:23

技能介绍

用途:该技能用于代码质量审查与重构,识别违反 amplihack 开发理念的反模式,并给出可操作的修复建议。适用于合并前代码评审、重构、创建新模块、理念合规检查、学习与团队指导等场景。

主要能力:检测五类代码坏味——过度抽象(如仅有单一实现的抽象基类、泛型工具类、超过 3 层的继承、过度参数化函数);复杂继承(继承层级 3 层以上、多继承、用继承代替组合);超大函数(超过 50 行、3 层以上嵌套、参数 5 个以上);紧耦合(方法内直接实例化依赖、深层属性链、硬编码类名、循环依赖);Python 模块缺少 all 导致公共接口不清晰。分析流程为扫描代码结构、逐项确认违规并评级、分别给出修改前后示例、生成按严重程度排序的报告。附带对应检测规则,例如统计抽象类实现数量、追踪继承链深度、计算函数行数、搜索方法内实例化、检查 all 是否存在。

使用方式:资料未提供具体安装命令或调用语法,仅说明其与代码评审流程、模块规格生成、重构工作流、架构讨论和指导学习配合使用;背景资料位于 ~/.amplihack/.claude/context/PHILOSOPHY.md 与 PATTERNS.md。

适用场景与限制:适合遵循 amplihack 理念的项目在评审、重构与教学时使用;检测规则带有明确阈值(继承不超过 2 层、函数不超过 50 行等),属于该理念的特定约定。资料未提供支持的编程语言范围(示例以 Python 为主)、运行平台、是否收费及具体安装步骤。