verification-loop

検証ループスキル

Claude Code セッション向けの包括的な検証システムです。

使用するタイミング

このスキルは、次の場合に実行します。

• 機能の実装や大規模なコード変更が完了した後
• PR を作成する前
• 品質ゲートを通過することを確認したいとき
• リファクタリングの後

検証フェーズ

以下のすべての例をそのまま実行するのではなく、現在のプロジェクトに合わせてコマンドを選択してください。リポジトリが以下のデフォルトの例に当てはまらない場合は、references/STACK-DETECTION.md に記載された、スタックに適したコマンドを使用してください。

フェーズ 1：ビルドの検証

# Python projects (uv)
uv build 2>&1 | tail -20
# OR
python -m build 2>&1 | tail -20

# Node.js projects
npm run build 2>&1 | tail -20
# OR
pnpm build 2>&1 | tail -20

ビルドに失敗した場合は、作業を中断し、先に修正してください。

フェーズ 2：型チェック

# TypeScript projects
npx tsc --noEmit 2>&1 | head -30

# Python projects
pyright . 2>&1 | head -30

すべての型エラーを報告してください。続行する前に、重大なエラーを修正してください。

フェーズ 3：Lint チェック

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

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

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

# Python projects
pytest --cov=src --cov-report=term-missing 2>&1 | tail -50

# Node.js projects
npm run test -- --coverage 2>&1 | tail -50

以下を報告してください。

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

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

# Python: Check for secrets
grep -rn "sk-" --include="*.py" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.py" . 2>/dev/null | head -10
pip-audit

# Node.js: Check for secrets
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

# Check for debug statements
grep -rn "print(" --include="*.py" src/ 2>/dev/null | head -10
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

フェーズ 6：差分レビュー

# Show what changed
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 分ごと、または大きな変更の後に検証を実行してください。

Set a mental checkpoint:
- After completing each function
- After finishing a component
- Before moving to next task

Run: /verify

フックとの統合

このスキルは PostToolUse フックを補完し、より詳細な検証を提供します。 フックは問題をすぐに検出し、このスキルは包括的なレビューを提供します。

参考ファイル

必要なものだけを読み込んでください。

• references/STACK-DETECTION.md - 現在のリポジトリに適した検証コマンドセットの選び方
• references/REPORT-TEMPLATE.md - 最終検証レポートの構成
• examples/example-verification-report.md - 最終レポートの例