mcpField
T
test-report-review

test-report-review

github.com/naodengテスト・品質28542 回インストール1 日前に更新
リポジトリ

test-report-review について

実行・欠陥の証拠、テスト範囲、役割別レポート、プロジェクトのアクションと照合してテストレポートを確認するスキルです。追跡可能なAI支援の推奨を作成し、最終判断は人間に委ねます。

主な機能

  1. 01情報源とバージョンの整理
  2. 02証拠と範囲に照らした主張の確認
  3. 03矛盾と残存リスクの提示
  4. 04pass、conditional_pass、rejectの判定規則
  5. 05人間による判断の保留

活用シーン

  1. 01リリース前のテスト合格主張のレビュー
  2. 02未テスト範囲と証拠不足の特定
  3. 03矛盾する品質レポートの整理
  4. 04条件と未完了アクションの追跡

インストール

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

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill test-report-review

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-conditional-pass.yaml
basic-pass.yaml
edge-hidden-untested-scope.yaml
edge-insufficient-evidence.yaml
edge-pm-override.yaml
review-report-reconciliation.yaml
evals/graders/
review-report-reconciliation.py
prompts/
test-report-review.md

詳細

テストレポートのレビュー

目標

テストレポートをソースの根拠、スコープ、役割別レポート、プロジェクトの対応と照合し、追跡可能なAI支援による推奨を作成します。提供された資料のみをレビューし、最終判断は人間が行います。

使用するタイミング

  • テストの合格、ゲートの達成、リリース準備完了を主張するレポートについて、ソース根拠のレビューが必要な場合。
  • 未テストのスコープ、根拠の矛盾、残存リスク、未完了の対応事項を明らかにする必要がある場合。
  • スケジュールやマネジメントからの情報が、QA、技術、またはソースの品質に関する事実と食い違う可能性がある場合。

ワークフロー

  1. prompts/test-report-review.mdを読み、仕様全体に従います。
  2. すべてのソースについて、識別子、バージョン、説明責任を負う役割、入手可否を一覧にします。バージョンが記載されていない場合は、推測せずnot suppliedと記載します。
  3. 各レポートの主張を、実行の根拠、不具合の根拠、テスト済み/未テストのスコープ、役割別レポート、プロジェクトの対応と照合します。
  4. 矛盾、非表示または不明なスコープ、残存リスク、条件、未完了の対応事項を、それぞれ出典とともに個別に列挙します。
  5. ブロッカーと条件のルールを適用し、AI支援によるpass、conditional_pass、rejectの推奨を出します。
  6. 提出前に、根拠の範囲、ソースのバージョン、担当者、人間が最終判断を行う権限が保留中であることを確認します。

不変条件

  • 実行の根拠と不具合の根拠の両方がない場合、状態は未実行または根拠不十分であり、推奨はrejectです。レポートの要約、役割に基づく意見、スケジュールによって、これを合格に変更することはできません。
  • 80/80や100%などの件数が示すのは、明示的な根拠がある実行スコープのみです。未テスト、省略、またはバージョン不明のスコープに決して外挿しないでください。
  • PMからの情報は、スケジュール、リソース、依存関係、担当者、対応状況の提供に限られます。実行結果、不具合の重大度/状態、品質に関する事実、リスク、人間の判断を変更することはできません。
  • すべての結論に、ソースとバージョンを明記してください。権限のある解決策が提示されるまでは、矛盾するソースをそのまま保持し、都合のよい方を選ばないでください。
  • 出力には常にAI支援による推奨と明記し、human_final_decision: pendingを維持してください。承認、リリース許可、リスク受容が行われたと主張してはいけません。

推奨ルール

  • reject:レビュー可能なレポートがない、実行の根拠と不具合の根拠の両方がない、重大な未テストスコープが隠されている、未対応のP0/P1がある、重大なソースの矛盾がある、または権限のない品質事実の上書きがあるなど、ブロッカーが存在する場合。
  • conditional_pass:ブロッカーはないものの、担当者、観測可能な完了ゲート、検証可能な完了根拠を追跡できる、範囲が限定された非ブロッキング条件がある場合。
  • pass:レポートとソースの根拠が一致しており、ブロッカーも条件もない場合。任意の改善事項は残っていてもかまいません。

指摘事項の件数だけで判断しないでください。肯定的な根拠があっても、重大なブロッカーを相殺することはできません。

出力仕様

次の順序で出力します:レビュー状況、ソースとバージョン、根拠の整合性マトリックス、テスト済み/未テストのスコープ、矛盾、ブロッカーと条件、残存リスク、未完了の対応事項、推奨の根拠と制限事項、人間への判断に関する質問。必須セクションはすべて残し、空の場合も「なし」と明記します。

段階的な読み込み

  • 実行のたびにprompts/test-report-review.mdを読みます。ここにレビュー仕様の全体が単独で記載されています。
  • このスキルは、ほかのスキル、プロジェクトパス、データベースオブジェクトに依存しません。役割別レポートが欠けている場合は入力不足として扱い、ほかのスキルの非公開ファイルを読まないでください。

よくある間違い

  • レポートの「すべて合格」という文を、実際の実行の根拠として扱う。
  • テスト済み件数を列挙する一方で、承認済みの除外項目、不明なスコープ、非表示の未テスト項目を記載しない。
  • fixedをverifiedとして扱う、または不具合記録がないことを不具合がない証拠とみなす。
  • リリース日が近いという理由で、失敗、不具合の重大度、リスクを書き換える。
  • 担当者またはunassignedの状態、完了ゲート、検証根拠を示さずにconditional_passを出す。

納品前チェック

  • 実行証跡と不具合証跡の有無およびバージョンが明記されています
  • レポートの主張、対象範囲、件数、ゲートが、元の証跡と照合されています
  • 矛盾、未テストの対象範囲、残存リスク、未完了のアクションが明示されています
  • すべての条件に担当者または unassigned、完了ゲート、検証証跡が設定されています
  • PM の入力が品質に関する事実を覆していません
  • 推奨事項がルールに従っており、human_final_decision: pending となっています

コメント