python-code-quality

Python コード品質

Python 品質スタックのオーケストレーションインデックスです。このスキルは、各ツールを担当する個別スキルへ案内するものであり、各ツールのコマンドを再掲するものではありません。スタック全体（lint＋フォーマット＋型チェック＋テスト）を一度にセットアップするときや、その仕組みを検討するときに利用してください。個別のツールを調整するときは、対応するスキルを利用してください。

このスキルを使用する場面

次のような場合にこのスキルを使用してください	次のような場合は代わりに対応する個別スキルを使用してください
新しいプロジェクトに品質スタック全体を導入する	ruff の lint ルールの選択だけを調整する — ruff-linting を使用してください
ツール同士の連携方法を検討する／比較する	ruff フォーマッター固有の動作だけを設定する — ruff-formatting を使用してください
lint＋型チェックを pre-commit と CI にまとめて組み込む	厳格な型チェッカーのルールを設定する — ty-type-checking または basedpyright-type-checking を使用してください

ルーティングテーブル

項目	個別スキル
lint ルール、ルールの選択、自動修正	python-plugin:ruff-linting
コードのフォーマット（引用符のスタイル、行の長さ）	python-plugin:ruff-formatting
ruff のエディター／pre-commit／CI／Docker への組み込み	python-plugin:ruff-linting → その REFERENCE.md
ty による型チェック	python-plugin:ty-type-checking
basedpyright による型チェック	python-plugin:basedpyright-type-checking
デッドコードの検出	python-plugin:vulture-dead-code
テストの品質／カバレッジ	python-plugin:python-testing、python-plugin:pytest-advanced
最新の型ヒント構文と慣用表現	python-plugin:python-development
プロジェクトへのツールの追加	python-plugin:uv-project-management

スタック全体の概要

このインデックスが扱うのは、pre-commit でツールを併用する方法です。 各ツールのフラグと設定については、上のルーティングテーブルを参照してください。

# .pre-commit-config.yaml — ruff (lint + format) and ty together
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.14.0
    hooks:
      - id: ruff-check
        args: [--fix]
      - id: ruff-format
  - repo: https://github.com/astral-sh/ty
    rev: v0.0.10
    hooks:
      - id: ty

一般的な CI 品質ゲートでは、同じ 3 つの手順を実行します：ruff check、 ruff format --check、ty check。実行可能な形式については、ruff-linting の「CI/CD Integration」と ty-type-checking を参照してください。

参考資料

• Ruff：https://docs.astral.sh/ruff/
• ty：https://docs.astral.sh/ty/