qa-reviewer

QA レビュアー：体系的な作業検証

目的

変更を確定する前に、AI エージェントの作業をレビューするための構造化されたフレームワークです。バグを見つけ、正確性を検証し、完全性を確保し、解決策が要件に合致しているかを確認します。

使用するタイミング

• ユーザーが「作業を確認して」または「これをレビューして」と依頼したとき
• 複雑な複数ステップの実装を完了した後
• 大規模なリファクタリングをコミットする前
• コマンドやスキルを変更するとき
• 新機能を実装した後
• 5 ステップを超えるタスクの後に、先回りして実施するとき

QA ワークフローのフェーズ

1. コンテキストの収集

• 元のタスクと要件を確認します
• すべての成果物（作成、変更、削除したファイル）を一覧にします
• リポジトリの指示ファイル（AGENTS.md、 AGENTS.override.md、CLAUDE.md、または設定済みのフォールバック）にある重要なルールを確認します

2. 要件の検証

• すべての要件のチェックリストを作成します
• 解決策が要件に沿っているか確認します
• エッジケースを確認します

3. 正確性の検証

• ファイルパスが存在することを確認します
• パターンがコードベースに合致することを確認します
• 引用を相互参照します

4. バグの検出

• 構文（Markdown、コード、パス）を確認します
• ロジックエラーを探します
• プロジェクト固有のルールを検証します

5. 完全性の監査

• ToDo リストを照合します
• 言及したすべてのファイルが変更されていることを確認します
• 副作用を確認します

6. 最適化のレビュー

• 解決策の品質を評価します
• パターンの一貫性を確認します
• 代替案を検討します

クイック検証コマンド

# Verify file exists
ls -la <file-path>

# Check balanced code blocks
grep -c '```' file.md

# Find violations
grep -r "console\.log" <files>
grep -r ": any" <files>

プロジェクトルールの確認

チェックリストの例です。リポジトリ独自の指示ファイルに記載されたルールに置き換えてください。

• console.log を使用していない（logger を使用する）
• any 型を使用していない
• インラインインターフェースを使用していない
• リポジトリの指示ファイルが保持され、スコープ付きの上書きが意図したものである
• 設定済みのフォールバック指示ファイルが存在し、内容が空でない
• タスクで変更が必要な場合を除き、エージェント設定フォルダーに手を加えていない
• プロジェクトの不変条件（プロジェクトにマルチテナンシーがある場合はその維持など）が保たれている

最終評価のカテゴリ

• 承認 - コミット可能
• 条件付き - 先に問題を修正
• 却下 - 重大な問題あり

---

ワークフローの全フェーズ、出力形式のテンプレート、よくある問題のパターン、高度なテクニックについては、包括的な QA を実施するとき、またはタスクの成果物が 3 つを超えるときに ${CLAUDE_SKILL_DIR}/references/full-guide.md を読み込んでください。