用途:该技能用于规范在开发流程中使用 Ruff(Python 代码检查与格式化工具)时的行为。资料显示它强调的是一套策略与覆盖规则,而非 Ruff 本身的命令语法;命令语法与通用用法应参考 astral:ruff(若已安装)或 docs.astral.sh,资料中不重复。
主要能力与规则:
- 禁止为了让 CI 通过而向 ruff check 传入 --ignore,也禁止以任何机制抑制 BLE001、D103、TRY300,包括不得通过配置排除来抑制。
- 使用 # noqa 需事先获得用户明确批准。
- 其他代码可用 pyproject.toml 中的 per-file 配置排除,但仅限真实规则冲突、测试规则本身的代码、有意的反例或 fixture、不修改的外部托管 vendored 代码、语法或类型上限较低的运行时(如旧版固定 CPython、MicroPython/CircuitPython 等变体),或修复成本高于收益的情况;每种情况需写明具体原因,而非只写类别名。
- --unsafe-fixes 仅在先用 --diff 审阅后再应用。
- 对每个改动的 Python 文件做完整格式化,不采用 Astral 默认的跳过未格式化文件建议,否则 ruff format --check --all-files 的构建会失败。
- 必须用 uv run ruff 调用,不用裸 ruff 或 uvx ruff,避免解析到与 lockfile 固定版本不同的版本。
适用场景:在集成该 Claude 技能的 Python 项目中进行代码检查、格式化与 CI 门禁时。
限制:资料未提供 Ruff 的安装步骤、版本号、性能数据或收费信息;具体命令语法应查阅官方文档。