用途:当用户要求检查代码质量、分析代码指标、查找死代码、检查风格合规或度量复杂度时使用,覆盖风格、复杂度、死代码与类型检查。
主要能力:风格合规方面检查行长度(Black 88、PEP8 79)、缩进4空格、导入顺序、命名约定与空白使用,常用命令如 black --check --diff .、flake8 --max-line-length=88 .、isort --check-only --diff .。复杂度方面报告圈复杂度(目标<10,10-20警告,>20严重)、认知复杂度、函数长度(目标<50行)、嵌套深度(目标<4层),可用 radon cc . -a -s、radon mi .、radon hal .。死代码方面识别未用导入、未用变量、未调用函数/类、不可达代码与废弃代码,可用 autoflake --check --remove-all-unused-imports . 或 flake8 --select=F401 .。类型方面用 mypy --strict .、mypy --disallow-untyped-defs . 检查缺失注解、类型错误与类型覆盖率(目标>80%)。
使用方式:完整分析按风格检查、复杂度分析、死代码扫描、类型检查、生成报告的顺序执行;快速检查可先由 git diff 取变更文件,再做针对性 lint、复杂度与类型验证。按错误、警告、信息三级输出发现。
适用场景:Python(Black、isort、flake8、mypy、radon、vulture)及 JavaScript/TypeScript(ESLint、Prettier、tsc)项目;可与重构、文档、安全扫描类技能协同。
限制:仅覆盖静态代码质量维度,不替代运行时测试;具体阈值与工具配置需按项目实际情况调整;官方资料未说明收费与平台支持情况。