SuperAPI AI 工具集

ruff-recursive-fix

通用与其它

查看项目

更新于 10-15 21:52

技能介绍

用途:在受控的迭代流程中用 Ruff 强制代码质量,支持限定到指定文件夹或文件、沿用 pyproject.toml 默认配置、灵活调用 Ruff(uv、直接 ruff、python -m ruff 等)、按次覆盖规则(--select、--ignore、--extend-select、--extend-ignore)、先安全后不安全的自动修复、每轮修复后审查 diff,并递归重复直到问题解决或需要决策。

主要能力:基线分析并按可安全自动修复、可自动修复但不安全、不可自动修复分类;安全自动修复轮次使用 --fix 并运行 format;不安全轮次使用 --fix --unsafe-fixes;手动修复剩余问题;仅在合理时使用行内 # noqa;每轮迭代都先 format 再 check。

使用方式:先收集 target_path、ruff_runner、rules_select、rules_ignore、extend_select、extend_ignore、allow_unsafe_fixes(默认 true)、ask_on_ambiguity(默认 true)。解析出统一的 ruff_cmd 前缀,基础命令为 <ruff_cmd> check,格式化命令为 <ruff_cmd> format,可附加目标路径与规则覆盖参数。示例:ruff check;python -m ruff check src/models;uv run ruff check src --extend-ignore D,TD;ruff check src/data --select F,E9,I。

适用场景:Python 项目代码质量治理、批量修复 lint 问题、在限定范围内按指定规则检查与修复。

限制:存在多种有效方案时必须询问用户,不静默选择;不安全修复可能影响行为,需重点审查并向用户提示;# noqa 仅在规则与必需行为、公共 API、框架约定或可读性冲突且重构代价不成比例时使用,并尽量写成 # noqa: <RULE> 并附原因;若循环无进展,需汇总受阻规则与文件、给出选项与权衡并请用户选择。完成时报告范围与选项、迭代次数、已修复问题、手动修复、抑制项及理由、剩余问题与所需决策。