Verification Loop Skill

Claude Code セッション用の包括的な検証システム。

使用するタイミング

このスキルを実行する場合：

• 機能の完成時または大きなコード変更後
• PR を作成する前
• 品質ゲートの確認を取りたいとき
• リファクタリング後

検証フェーズ

フェーズ 1: ビルド検証

# プロジェクトがビルドできるか確認
npm run build 2>&1 | tail -20
# または
pnpm build 2>&1 | tail -20

ビルドが失敗した場合、修正してから続行してください。

フェーズ 2: 型チェック

# TypeScript プロジェクト
npx tsc --noEmit 2>&1 | head -30

# Python プロジェクト
pyright . 2>&1 | head -30

すべての型エラーを報告します。重大なエラーは修正してから続行してください。

フェーズ 3: Lint チェック

# JavaScript/TypeScript
npm run lint 2>&1 | head -30

# Python
ruff check . 2>&1 | head -30

フェーズ 4: テストスイート

# カバレッジ付きでテストを実行
npm run test -- --coverage 2>&1 | tail -50

# カバレッジ閾値の確認
# 目標: 最小 80%

以下の内容を報告します：

• テスト総数: X
• 成功: X
• 失敗: X
• カバレッジ: X%

フェーズ 5: セキュリティスキャン

# シークレットの確認
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10

# console.log の確認
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

フェーズ 6: Diff レビュー

# 変更内容を表示
git diff --stat
git diff HEAD~1 --name-only

変更されたファイルを以下の点でレビューします：

• 意図しない変更がないか
• エラーハンドリングが不足していないか
• 予期しないケースがないか

出力形式

すべてのフェーズを実行した後、検証レポートを作成します：

VERIFICATION REPORT
==================

Build:     [PASS/FAIL]
Types:     [PASS/FAIL] (X errors)
Lint:      [PASS/FAIL] (X warnings)
Tests:     [PASS/FAIL] (X/Y passed, Z% coverage)
Security:  [PASS/FAIL] (X issues)
Diff:      [X files changed]

Overall:   [READY/NOT READY] for PR

Issues to Fix:
1. ...
2. ...

継続モード

長いセッションでは、15 分ごとまたは大きな変更後に検証を実行します：

メンタルチェックポイントを設定：
- 各関数の完成後
- コンポーネント完成後
- 次のタスクに移る前

実行: /verify

フックとの統合

このスキルは PostToolUse フックを補完しますが、さらに深い検証を行います。 フックは問題を即座に検出し、このスキルは包括的なレビューを提供します。