用途：把 Ruff 配置为 Python 包唯一的 linter 与 formatter，替代 Black、Flake8（含插件）、isort 和 pyupgrade，在 pyproject.toml 中写明显式规则集，并让 ruff check 与 ruff format --check 干净通过。每个命令都在用户的包仓库中运行。
主要能力：新建配置；从旧工具栈迁移；规则调优；修复 lint 或格式失败，包括安全修复、不安全修复的审查，以及 GitHub Actions 中的注解输出。
必要用法：先检查现有配置（.flake8、.isort.cfg、setup.cfg、tox.ini、ruff.toml 等，以及 pyproject.toml 中的 [tool.ruff]/[tool.black]/[tool.isort]、requires-python），再选择新建、迁移、调优或修复路径。安装需固定版本，例如 uv add --dev "ruff==0.16.6"，或一次性 uvx --from 'ruff==0.16.6' ruff check .；无 uv 时用 python -m pip install 'ruff==0.16.6'。配置建议设置 target-version、line-length、显式 select、ignore = ["E501"]、per-file-ignores 和 [tool.ruff.format]，并通过可选 required-version 锁定版本。修复流程为 uv run ruff check . --fix、uv run ruff format .、uv run ruff check .，最后用 uv run ruff check . && uv run ruff format --check . 验证，并可运行 scripts/check_ruff_config.py 做只读检查。
适用场景：为 Python 包统一 lint 与格式化、从 Black/Flake8/isort 迁移、出现红色 lint 门禁需要修复时。
限制：Ruff 不做类型推断，类型检查归 mypy/pyright/ty；pre-commit 接线、CI 工作流 YAML、非 Python 文件格式化以及代理编辑时的自动运行分别属于其他技能；Ruff 只格式化 Python。资料未提供官方文本、价格或平台信息。