qlty-check

Qlty コード品質

qlty CLI を介して、40 以上の言語に対応した 70 以上のリンターをサポートする、汎用コード品質ツールです。

使用する場面

• コミットや引き継ぎの前に、コードのリンティング問題を確認する
• フォーマットやスタイルの問題を自動修正する
• コードメトリクス（複雑度、重複）を算出する
• コードの不適切なパターンを見つける

クイックリファレンス

# Check changed files with auto-fix
uv run python -m runtime.harness scripts/qlty_check.py --fix

# Check all files
uv run python -m runtime.harness scripts/qlty_check.py --all

# Format files
uv run python -m runtime.harness scripts/qlty_check.py --fmt

# Get metrics
uv run python -m runtime.harness scripts/qlty_check.py --metrics

# Find code smells
uv run python -m runtime.harness scripts/qlty_check.py --smells

パラメーター

パラメーター	説明
--check	リンターを実行します（デフォルト）
--fix	問題を自動修正します
--all	変更されたファイルだけでなく、すべてのファイルを処理します
--fmt	代わりにファイルをフォーマットします
--metrics	コードメトリクスを算出します
--smells	コードの不適切なパターンを見つけます
--paths	特定のファイル／ディレクトリを指定します
--level	問題レベルの下限：note/low/medium/high
--cwd	作業ディレクトリ
--init	リポジトリで qlty を初期化します
--plugins	利用可能なプラグインを一覧表示します

よくあるワークフロー

実装後

# Auto-fix what's possible, see what remains
uv run python -m runtime.harness scripts/qlty_check.py --fix

品質レポート

# Get metrics for changed code
uv run python -m runtime.harness scripts/qlty_check.py --metrics

# Find complexity hotspots
uv run python -m runtime.harness scripts/qlty_check.py --smells

新しいリポジトリで初期化

uv run python -m runtime.harness scripts/qlty_check.py --init --cwd /path/to/repo

直接 CLI を使用する場合（qlty がインストール済みの場合）

# Check changed files
qlty check

# Auto-fix
qlty check --fix

# JSON output
qlty check --json

# Format
qlty fmt

要件

• qlty CLI：https://github.com/qltysh/qlty
• MCP サーバー：servers/qlty/server.py が CLI をラップします
• 設定：リポジトリ内の .qlty/qlty.toml（最初に qlty init を実行してください）

他のツールとの比較

ツール	用途
qlty	あらゆる言語に対応した、統合型のリンティング、フォーマット、メトリクス
ast-grep	構造的なコードパターンの検索とリファクタリング
morph	高速なテキスト検索