SuperAPI AI 工具集

py-code-health

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:维护 Python 代码健康,检测未使用的函数、类、变量,识别跨文件重复代码,移除冗余导入与注释掉的旧代码,并把相似逻辑合并为参数化函数或配置驱动实现。

主要能力:使用 vulture 做基于 AST 的死代码检测,支持置信度过滤、按体积排序和目录排除;使用 pylint 的 duplicate-code 检查检测相似代码块,可配置最小相似行数并输出 JSON。文档还给出参数化函数、提取公共校验逻辑、用配置替代重复分支等合并模式,以及用 whitelist.py 处理动态导入、框架约定、公共 API 等误报。

使用方式:需在 [dependency-groups] dev 中加入 "vulture"、"pylint",并先运行 py-quality-setup 配置 .claude/settings.local.json 的工具权限。常用命令:vulture . --min-confidence 80;pylint --disable=all --enable=duplicate-code --recursive=y .。

适用场景:Python 项目清理死代码、消除重复、降低维护成本,尤其适合重构前建立安全网。

限制:vulture 存在误报,60-70% 置信度可能为动态导入或元类等场景;删除前需验证调用点,公共 API 可加入白名单;文档未提供具体收费、平台或效果数据。