SuperAPI AI 工具集

py-refactor

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:py-refactor 是 Python 重构编排器,用于协调多个专项技能,系统化提升 Python 代码质量。它本身不直接执行重构,而是按影响优先级调度子技能。

主要能力:协调 py-security(漏洞检测与修复)、py-code-health(死代码与重复代码清理)、py-complexity(降低圈复杂度与认知复杂度)、py-test-quality(覆盖率分析与变异测试)、py-modernize(工具与语法升级)、py-quality-setup(配置 linter 与类型检查器)、py-git-hooks(设置 pre-commit 钩子)。

优先级:严重为安全漏洞;高为代码重复、未测试代码(覆盖率低于 80%);中为复杂度降低、死代码移除;低为语法现代化与风格改进。

使用方式:先按需调用 py-quality-setup 配置工具,并在 pyproject.toml 的 [dependency-groups] dev 中加入 radon、vulture、pylint、bandit、lizard、pytest-cov、mutmut、wily、ruff、mypy、basedpyright,然后执行 uv sync && source .venv/bin/activate。分析阶段运行 ruff、bandit、vulture、pylint、radon、lizard、pytest --cov、wily build 等命令生成报告。随后按安全、测试质量、代码健康、复杂度、现代化的顺序调用对应技能,最后用 ruff、mypy、basedpyright、radon、vulture、pytest --cov-fail-under=80 做最终验证,并用 wily diff 与 wily report 跟踪改进。

适用场景:需要系统性重构的 Python 项目,尤其是存在安全、重复、复杂度或测试覆盖不足问题的代码库。

限制:单一聚焦任务应直接使用对应技能;无测试时应先写测试;活跃开发期需与团队协调避免冲突;生产事故应先修复再重构。资料未提供具体收费、价格与平台信息。