mcpField
R
Requirements Validation

Requirements Validation

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

Requirements Validation について

開発前に要件が明確で完全かつ一貫し、テスト可能でビジネスニーズに沿うかを確認するスキルです。レビュー、プロトタイピング、受け入れ基準の確認、トレーサビリティを組み合わせます。

主な機能

  1. 01ピアレビューとステークホルダー承認
  2. 02プロトタイプによるUI/UX検証
  3. 03受け入れ基準のレビュー
  4. 04要件トレーサビリティマトリクス
  5. 05INVESTによるユーザーストーリー確認
  6. 06曖昧さと要件の競合への対応

活用シーン

  1. 01開発開始前の要件レビュー
  2. 02モックアップによるUI/UX期待値の検証
  3. 03要件と設計・テストの関連付け

インストール

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

$npx skills add https://github.com/danhvb/my-ba-skills --skill requirements-validation

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

詳細

要件検証スキル

目的

開発を始める前に、要件が正確で、網羅的かつ一貫性があり、ビジネス上の課題を実際に解決することを確認します。「正しいものを作る」ことと「ものを正しく作る」ことの違いです。

検証と妥当性確認

  • Verification(検証):「製品を正しく作っていますか?」(要件は品質基準を満たしていますか?)
  • Validation(妥当性確認):「正しい製品を作っていますか?」(要件はユーザーのニーズを解決していますか?)

主な妥当性確認の手法

1. ピアレビュー/ウォークスルー
  • プロセス:同僚(開発者、他のビジネスアナリスト)による非公式または準公式のレビューです。
  • 目標:ロジックの誤り、曖昧さ、考慮漏れのあるエッジケースを見つけます。
  • チェックリスト:
    • 明確ですか?
    • テスト可能ですか?
    • 実現可能ですか?
2. ステークホルダーによるインスペクション/承認
  • プロセス:ビジネスオーナーによる正式なレビューです。
  • 目標:次の段階に進むための承認を得ます。
  • 方法:ドキュメントを読むだけではなく、シナリオや例を使って確認します。
3. プロトタイピング
  • 方法:言葉で説明するのではなく、実物を見せます。ワイヤーフレームやモックアップを使用します。
  • 目標:UI/UX 要件を妥当性確認します。「思い描いていたものと同じですか?」
4. 受け入れ基準のレビュー
  • 方法:「Given-When-Then」シナリオをレビューします。
  • 目標:要件がテスト可能なほど具体的であることを確認します。

要件トレーサビリティマトリックス(RTM)

目的

要件をその起点と下流の成果物に関連付けます。

  • 前方トレーサビリティ:要件 → 設計 → コード → テスト。(必要なものがすべて構築されていることを確認します)。
  • 後方トレーサビリティ:テスト → 要件 → ビジネス目標。(「過剰な作り込み」や不要な機能がないことを確認します)。
RTM テンプレート
要件 ID説明ソース(ステークホルダー)ビジネス目標設計書テストケース IDステータス
FR-01ゲストチェックアウトマーケティング担当副社長コンバージョン増加DD-CheckoutTC-001, 002実装済み
FR-02Apple PayCEOモバイル戦略DD-PaymentTC-005承認済み
FR-033D Secureコンプライアンス法的要件DD-SecurityTC-010テスト済み

品質チェックリスト(INVEST)

ユーザーストーリーの場合:

  • Independent(独立している)
  • Negotiable(交渉可能である)
  • Valuable(価値がある)
  • Estimable(見積もり可能である)
  • Small(小さい)
  • Testable(テスト可能である)

妥当性確認で見つかった問題への対処

  1. 曖昧さ:「システムは高速でなければならない。」
    • 修正:「システムは 2 秒未満で読み込まなければならない。」
  2. 意見の相違:ステークホルダー A は青を、B は赤を希望しています。
    • 修正:交渉を調整するか、スポンサーにエスカレーションします。
  3. 不完全さ:エラー状態が欠落しています。
    • 修正:「これが失敗した場合、どうなりますか?」と尋ねます。

成果物

  • 妥当性確認済み要件パッケージ:整理され、承認されたドキュメント。
  • 承認記録:スコープを承認したメールまたは電子署名。
  • 更新済みトレーサビリティマトリックス。

ツール

  • Jira(ストーリーをエピック/テストに関連付けます)。
  • Excel/Lark Base(RTM)。
  • Confluence/Lark Docs(承認)。

コメント