mcpField
R
router-qa

router-qa

github.com/vasilyu1983テスト・品質43 回インストール
リポジトリ

router-qa について

テスト、可観測性、レジリエンス、デバッグ、ドキュメント品質の依頼を12の専門スキルに振り分ける QA ルーティングスキルです。実装、ドキュメント作成、デプロイ作業への引き継ぎも定めています。

主な機能

  1. 0112の QA スキルへの振り分け
  2. 02テスト、デバッグ、可観測性への対応
  3. 03複数スキルによる QA ワークフロー
  4. 04実装やデプロイ作業の引き継ぎ
  5. 05ルーティング表と品質ゲート

活用シーン

  1. 01テスト戦略やテストスキルの選定
  2. 02本番環境のデバッグ依頼の振り分け
  3. 03可観測性やレジリエンス施策の計画
  4. 04ドキュメント品質の網羅状況の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vasilyu1983/ai-agents-public --skill router-qa

インストール後、Claude Code で/router-qaを入力して読み込まれたか確認します。

詳細

ルーター：品質保証

テスト、オブザーバビリティ、レジリエンス、デバッグ、ドキュメント品質に関する質問を、12 個の専門 QA スキルに振り分ける、品質エンジニアリングのマスターオーケストレーターです。依頼が QA の範囲外（実装、ドキュメント作成、デプロイ）の場合は、明示的に引き継ぎます。

クイック判断ツリー

QA QUESTION
    │
    ├─► "What tests do I need?" ──────────► qa-testing-strategy
    │                                        └─► Test pyramid, coverage, risk-based
    │
    ├─► "Write E2E tests" ────────────────► qa-testing-playwright
    │                                        └─► Selectors, page objects, CI/CD
    │
    ├─► "Test iOS app" ───────────────────► qa-testing-ios
    │                                        └─► XCTest, simulators, device matrix
    │
    ├─► "Test mobile app" ────────────────► qa-testing-mobile
    │                                        └─► Cross-platform, Android + iOS
    │
    ├─► "Test Android app" ──────────────► qa-testing-android
    │                                        └─► Espresso, UIAutomator, Compose
    │
    ├─► "Test API contracts" ─────────────► qa-api-testing-contracts
    │                                        └─► OpenAPI, Pact, schema validation
    │
    ├─► "Test LLM agent" ─────────────────► qa-agent-testing
    │                                        └─► Scenarios, scoring, refusals
    │
    ├─► "Debug this issue" ───────────────► qa-debugging
    │                                        └─► Stack traces, logging, profiling
    │
    ├─► "Setup monitoring" ───────────────► qa-observability
    │                                        └─► OpenTelemetry, SLOs, tracing
    │
    ├─► "Handle failures" ────────────────► qa-resilience
    │                                        └─► Circuit breakers, retries, chaos
    │
    ├─► "Refactor safely" ────────────────► qa-refactoring
    │                                        └─► Characterization tests, seams
    │
    └─► "Check docs coverage" ────────────► qa-docs-coverage
                                             └─► Gap analysis, runbook validation

スキル一覧（QA スキル 12 個）

テストスキル（7 個）
スキル目的主なトリガー
qa-testing-strategyテストピラミッド、リスクベーステスト、カバレッジ「テスト戦略」、「どのテスト」、「カバレッジ」
qa-testing-playwrightPlaywright による Web の E2E テスト「E2E テスト」、「Playwright」、「ブラウザテスト」
qa-testing-iosXCTest／XCUITest による iOS テスト「iOS テスト」、「XCTest」、「シミュレーター」
qa-testing-androidEspresso／UIAutomator による Android テスト「Android テスト」、「Espresso」、「UIAutomator」、「Compose テスト」
qa-testing-mobileクロスプラットフォームのモバイルテスト「モバイルテスト」、「クロスプラットフォーム」、「デバイスマトリックス」
qa-api-testing-contractsAPI スキーマとコントラクトのテスト「API テスト」、「コントラクト」、「OpenAPI」、「Pact」
qa-agent-testingLLM エージェントとペルソナのテスト「エージェントテスト」、「LLM テスト」、「拒否」、「スコアリング」
品質スキル（5 個）
スキル目的主なトリガー
qa-debuggingデバッグ、ログ記録、プロファイリング「デバッグ」、「エラー」、「スタックトレース」、「プロファイル」
qa-observabilityメトリクス、トレース、ログ、SLO「監視」、「トレーシング」、「SLO」、「OpenTelemetry」
qa-resilienceサーキットブレーカー、リトライ、カオステスト「サーキットブレーカー」、「リトライ」、「カオス」、「タイムアウト」
qa-refactoring安全なリファクタリング、技術的負債「リファクタリング」、「コードの臭い」、「技術的負債」
qa-docs-coverageドキュメント品質ゲート「ドキュメントカバレッジ」、「未文書化」、「ランブック」

正式な一覧（信頼できる情報源）

QA スキル、トリガー、期待される出力、ルーティングルールの正式な一覧として、frameworks/shared-skills/skills/router-qa/data/skill-registry.json を使用してください。

任意のウェブ検索用参考情報には、frameworks/shared-skills/skills/router-qa/data/sources.json を使用してください（各専門スキルは、必要に応じて独自の情報源を管理します）。

ドメインの検出

ドメイン 1：テスト計画

トリガー：「どのテスト」、「テスト戦略」、「カバレッジ」、「テストピラミッド」、「シフトレフト」、「リスクベース」

ルーティング先：qa-testing-strategy

質問例：

  • 「この API にはどのようなテストが必要ですか？」
  • 「テストの優先順位はどのように決めればよいですか？」
  • 「適切なテストカバレッジの目標値はどれくらいですか？」
ドメイン 2：E2E および UI テスト

トリガー：「E2E」、「エンドツーエンド」、「Playwright」、「ブラウザテスト」、「UI テスト」、「ページオブジェクト」、「ビジュアルテスト」

ルーティング先：qa-testing-playwright

質問例：

  • 「ログインの Playwright テストを書いてください」
  • 「不安定な E2E テストにはどう対処すればよいですか？」
  • 「ページオブジェクトのベストプラクティスを教えてください」
ドメイン 3：モバイルテスト

トリガー：「iOS」、「Android」、「モバイル」、「XCTest」、「XCUITest」、「Espresso」、「UIAutomator」、「Appium」、「シミュレーター」、「エミュレーター」、「デバイス」

トリガールーティング先
iOS のみqa-testing-ios
Android のみqa-testing-android
クロスプラットフォームqa-testing-mobile

質問例：

  • 「シミュレーターで iOS アプリをテストする」
  • 「Android のログイン用に Espresso テストを書いてください」
  • 「Jetpack Compose の UI をテストする」
  • 「Android テスト用のデバイスマトリックス」
  • 「クロスプラットフォームのモバイルテスト戦略」
ドメイン 4：API およびコントラクトテスト

トリガー：「API テスト」、「コントラクトテスト」、「OpenAPI」、「GraphQL テスト」、「gRPC」、「Pact」、「スキーマ検証」

ルーティング先：qa-api-testing-contracts

質問例：

  • 「REST API のコントラクトテストを書いてください」
  • 「OpenAPI スキーマを検証する」
  • 「コンシューマー駆動コントラクトテスト」
ドメイン 5：エージェントテスト

トリガー：「エージェントテスト」、「LLM テスト」、「ペルソナ」、「拒否」、「AI セーフティ」、「スコアリングルーブリック」、「テストハーネス」

ルーティング先：qa-agent-testing

質問例：

  • 「チャットボット用のテストスイートを作成する」
  • 「LLM の拒否境界をテストする」
  • 「エージェントの応答を評価する」
ドメイン 6：デバッグ

トリガー：「debug」、「error」、「bug」、「crash」、「stack trace」、「logging」、「profiling」、「troubleshoot」

ルーティング先：qa-debugging

質問の例：

  • 「メモリリークをデバッグする」
  • 「このスタックトレースを分析する」
  • 「構造化ログを設定する」
ドメイン 7：可観測性

トリガー：「monitor」、「metrics」、「tracing」、「logging」、「SLO」、「SLI」、「OpenTelemetry」、「APM」、「alert」

ルーティング先：qa-observability

質問の例：

  • 「Node.js 用に OpenTelemetry を設定する」
  • 「API の SLO を定義する」
  • 「分散トレーシング戦略」
ドメイン 8：レジリエンス

トリガー：「circuit breaker」、「retry」、「timeout」、「backoff」、「chaos」、「fault injection」、「degradation」、「health check」

ルーティング先：qa-resilience

質問の例：

  • 「サーキットブレーカーを実装する」
  • 「外部 API のリトライ戦略」
  • 「カオスエンジニアリングを設定する」
ドメイン 9：リファクタリング

トリガー：「refactor」、「code smell」、「tech debt」、「legacy code」、「characterization test」、「strangler fig」

ルーティング先：qa-refactoring

質問の例：

  • 「このレガシーコードを安全にリファクタリングする」
  • 「リファクタリング前にテストを追加する」
  • 「技術的負債を管理する」
ドメイン 10：ドキュメントの品質

トリガー：「docs coverage」、「undocumented」、「runbook」、「API docs audit」、「stale docs」

ユーザーが CLAUDE.md／AGENTS.md／プロジェクトメモリー／大規模コードベースのセットアップについて尋ねた場合：agents-project-memory にルーティングします（補助：qa-docs-coverage、docs-codebase）

質問の例：

  • 「ドキュメントの網羅性を監査する」
  • 「ドキュメント化されていない API を見つける」
  • 「ランブックを検証する」
  • 「大規模コードベース向けに CLAUDE.md を設定する」
  • 「クロスプラットフォーム対応の AGENTS.md を作成する」

ワークフローパターン

パターン 1：テストファースト開発
START
  │
  ▼
qa-testing-strategy ────────► Define test pyramid
  │
  ├─► Unit tests ──────────► Write inline
  ├─► Integration tests ───► Write with mocks
  └─► E2E tests ───────────► qa-testing-playwright
  │
  ▼
qa-api-testing-contracts ──► Contract tests (if API)
  │
  ▼
TESTS COMPLETE
パターン 2：バグ調査
BUG REPORTED
  │
  ▼
qa-debugging ──────────────► Analyze logs, traces, stack
  │
  ├─► Need more visibility? → qa-observability
  ├─► Failure mode issue? ──→ qa-resilience
  └─► Code quality issue? ──→ qa-refactoring
  │
  ▼
ROOT CAUSE IDENTIFIED
  │
  ▼
qa-testing-strategy ───────► Add regression test
  │
  ▼
BUG FIXED + COVERED
パターン 3：本番環境の強化
PRE-PRODUCTION
  │
  ▼
qa-resilience ─────────────► Error handling, retries
  │
  ▼
qa-observability ──────────► Metrics, tracing, SLOs
  │
  ▼
qa-testing-strategy ───────► Smoke + E2E tests
  │
  ▼
PRODUCTION READY
  │
  ▼
qa-resilience ─────────────► Chaos experiments (post-launch)
パターン 4：レガシーシステムのモダナイゼーション
LEGACY CODEBASE
  │
  ▼
qa-refactoring ────────────► Characterization tests
  │
  ▼
qa-testing-strategy ───────► Add missing test coverage
  │
  ▼
qa-refactoring ────────────► Incremental refactoring
  │
  ▼
qa-docs-coverage ──────────► Document updated code
  │
  ▼
MODERNIZED
パターン 5：LLM エージェントの品質
AGENT DEVELOPMENT
  │
  ▼
qa-agent-testing ──────────► Define test scenarios
  │
  ├─► Must-ace tasks ──────► Core functionality
  ├─► Refusal tests ───────► Safety boundaries
  └─► Scoring rubric ──────► Quality metrics
  │
  ▼
qa-observability ──────────► Token usage, latency metrics
  │
  ▼
VALIDATED AGENT
パターン 6：大規模コードベースのドキュメント化（100K-1M LOC）
LARGE CODEBASE
  │
  ▼
agents-project-memory ► Hierarchical CLAUDE.md setup
  │                          (root + subdirectory docs)
  ├─► Root CLAUDE.md ────────► Architecture, conventions
  ├─► Subdirectory docs ─────► Module-specific context
  ├─► AGENTS.md symlink ─────► Cross-platform support
  │
  ▼
qa-docs-coverage ──────────► Audit existing documentation
  │
  ▼
docs-codebase ─────────────► Fill critical gaps
  │
  ▼
LLM-READY CODEBASE

スキルチェーン

チェーン：QA の完全なセットアップ
qa-testing-strategy → qa-testing-playwright → qa-api-testing-contracts
     ↓
qa-resilience → qa-observability → qa-debugging
     ↓
qa-refactoring → qa-docs-coverage
チェーン：インシデント対応
qa-debugging → qa-observability → qa-resilience → qa-refactoring
チェーン：モバイルアプリのテスト
qa-testing-strategy → qa-testing-mobile → qa-testing-ios (if iOS) → qa-testing-android (if Android)

品質ゲート

リリース前チェックリスト
ゲートスキル基準
テストカバレッジqa-testing-strategyカバレッジ目標がリスクと重要なパスに合致している
E2E テストの合格qa-testing-playwright重要なパスがすべて合格している
API コントラクトqa-api-testing-contractsスキーマ検証に合格している
エラーハンドリングqa-resilienceサーキットブレーカーが設定されている
モニタリングqa-observabilitySLO が定義され、アラートが設定されている
ドキュメントqa-docs-coverageAPI と README が完成している
インシデント後チェックリスト
ゲートスキルアクション
根本原因qa-debugging調査結果を文書化する
リグレッションテストqa-testing-strategy障害モードのテストを追加する
防止策qa-resilienceサーキットブレーカーを追加／調整する
可視性qa-observability不足しているトレース／アラートを追加する

ルーティングマトリクス

ユーザーの意図主要スキル補助スキル
テストを計画するqa-testing-strategyqa-testing-playwright、qa-api-testing-contracts
E2E テストを書くqa-testing-playwrightqa-testing-strategy
モバイルをテストするqa-testing-mobile、qa-testing-ios、または qa-testing-androidqa-testing-strategy
API をテストするqa-api-testing-contractsqa-testing-strategy
エージェントをテストするqa-agent-testingqa-testing-strategy
問題をデバッグするqa-debuggingqa-observability、qa-resilience
モニタリングを設定するqa-observabilityqa-debugging
レジリエンスを追加するqa-resilienceqa-observability
コードをリファクタリングするqa-refactoringqa-testing-strategy
ドキュメントを監査するqa-docs-coveragedocs-codebase
大規模コードベースをセットアップするagents-project-memoryqa-docs-coverage、docs-codebase

ルーター間の引き継ぎ

router-engineering へのルーティング

ユーザーが実装を必要としている場合：

  • 「機能を構築する」 → software-backend または software-frontend にルーティングします
  • 「修正を実装する」 → 該当するエンジニアリングスキルにルーティングします
router-operations へのルーティング

ユーザーがデプロイ／インフラを必要としている場合：

  • 「本番環境にデプロイする」 → ops-devops-platform にルーティングします
  • 「CI/CD をセットアップする」 → ops-devops-platform にルーティングします
router-operations からのルーティング

オペレーションルーターが QA のニーズを検知した場合：

  • 「テスト戦略」 → ここにルーティングします
  • 「本番環境の問題をデバッグする」 → ここにルーティングします
  • 「レジリエンスを追加する」 → ここにルーティングします

クイックリファレンスコマンド

ニーズ実行すること
テスト戦略→ qa-testing-strategy
E2E テスト→ qa-testing-playwright
iOS テスト→ qa-testing-ios
Android テスト→ qa-testing-android
モバイルテスト→ qa-testing-mobile
API テスト→ qa-api-testing-contracts
エージェントテスト→ qa-agent-testing
問題のデバッグ→ qa-debugging
モニタリング→ qa-observability
レジリエンス→ qa-resilience
リファクタリング→ qa-refactoring
ドキュメントの品質→ qa-docs-coverage

関連ルーター

ルーター関係
router-operations親ルーター。QA + DevOps + git を含みます
router-engineering実装タスクの引き継ぎ先
router-startupビジネス／プロダクトに関する質問の引き継ぎ先

コメント

Markdown 対応