Code Quality Gate スキル

このスキルは、Constitution Article 5: Code Quality Standards を強制し、コード品質基準の完全遵守を保証します。

起動条件

以下の状況で自動起動します：

1. コミット前:

   git commit

   を実行する前の最終チェック
2. PR作成前: プルリクエストを作成する前
3. 品質問題検出時: コードに品質問題がある可能性がある場合
4. 明示的な依頼: ユーザーが品質チェックを依頼した場合

品質チェック項目

1. Ruff Linter

コードスタイルとベストプラクティスの検証

# エラーチェック
uv run ruff check .

# 自動修正
uv run ruff check --fix .

チェック内容:

• 未使用のインポート
• 未使用の変数
• コードスタイル違反
• セキュリティ問題
• パフォーマンス問題

2. Ruff Formatter

コードフォーマットの統一

# フォーマットチェック（差分表示）
uv run ruff format --check .

# 自動フォーマット
uv run ruff format .

チェック内容:

• インデント
• 行の長さ
• 空白の使用
• クォートの統一

3. Mypy Type Checker

静的型チェック

# 型チェック実行
uv run mypy .

チェック内容:

• 型アノテーションの存在（Article 9）
• 型の整合性

• Any

  型の過剰使用

• None

  チェックの欠落

実行プロセス

Quick Check（高速チェック）

# すべてのチェックを一度に実行
uv run ruff check . && uv run ruff format --check . && uv run mypy .

Full Check with Auto-fix（自動修正付き完全チェック）

# 自動修正を適用して再チェック
uv run ruff check --fix . && uv run ruff format . && uv run mypy .

Step-by-Step（段階的チェック）

問題を個別に解決したい場合：

# Step 1: Linter
uv run ruff check .

# Step 2: Formatter
uv run ruff format --check .

# Step 3: Type Checker
uv run mypy .

品質ゲート基準

PASS条件

すべてのチェックがエラーなしで完了：

✓ ruff check: 0 errors
✓ ruff format: No changes needed
✓ mypy: Success: no issues found

FAIL条件

いずれかのチェックでエラーが発生：

✗ ruff check: 3 errors found
✗ ruff format: 2 files would be reformatted
✗ mypy: Found 5 errors in 2 files

エラー対応ガイド

Ruff エラーの修正

# エラー一覧の確認
uv run ruff check .

# 自動修正可能なエラーを修正
uv run ruff check --fix .

# 手動修正が必要なエラーは個別対応
# エラーコードのドキュメントを参照

Format エラーの修正

# 自動フォーマット適用
uv run ruff format .

Mypy エラーの修正

missing return type

missing argument type

incompatible types

None not allowed

型アノテーション例:

# Before (エラー)
def greet(name):
    return f"Hello, {name}"

# After (修正)
def greet(name: str) -> str:
    return f"Hello, {name}"

レポート形式

チェック完了後、以下の形式でレポート：

## Code Quality Gate Report

### チェック結果
| Tool | Status | Details |
|------|--------|---------|
| ruff check | ✓ PASS | 0 errors |
| ruff format | ✓ PASS | No changes |
| mypy | ✓ PASS | No issues |

### 総合判定: PASS

コミット/PR作成を進めてください。

または

## Code Quality Gate Report

### チェック結果
| Tool | Status | Details |
|------|--------|---------|
| ruff check | ✗ FAIL | 3 errors |
| ruff format | ✓ PASS | No changes |
| mypy | ✗ FAIL | 5 errors |

### 総合判定: FAIL

以下のエラーを修正してください：

1. ruff: E501 Line too long (src/auth.py:45)
2. ruff: F401 Unused import (src/utils.py:1)
3. mypy: Missing return type (src/auth.py:10)
...

注意事項

• 例外なし: Article 5 は非交渉的原則
• 時間制約は理由にならない: 品質を犠牲にしない
• 自動修正を活用: 可能な限り自動修正を適用
• ゲート通過必須: PASSするまでコミット/PRは行わない

推奨ワークフロー

1. コードを書く

2. uv run ruff check --fix . && uv run ruff format .

   を実行

3. uv run mypy .

   を実行
4. エラーがあれば修正
5. すべてPASSしたらコミット

# 一連のコマンド
uv run ruff check --fix . && uv run ruff format . && uv run mypy . && git add . && git commit -m "message"