requirements-author について
BRDとPRDをライフサイクルに沿って作成・管理するためのスキルです。テンプレート、トレーサビリティ、品質確認、文書間の引き継ぎを扱います。
主な機能
- 01BRD・PRDのライフサイクル指針
- 02標準ドキュメントテンプレート
- 03要件トレーサビリティ規則
- 04品質ゲートとレポート
- 05検証付きドキュメント引き継ぎ
活用シーン
- 01ビジネス要件の作成
- 02製品要件ドキュメントの作成
- 03トレーサビリティと品質の確認
- 04承認済み範囲のBRDからPRDへの引き継ぎ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoft/ hve-core --skill requirements-authorインストール後、Claude Code で/requirements-authorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/_shared/atomicity-checklist.mddesign-decisions.mddiagram-format-selector.mdgiven-when-then.mdid-schema.mdiso-29148-quality-attrs.mdmendelow-matrix.mdmoscow.mdprioritization-schemes.mdprocess-modeling.mdquality-rubric.mdraci-patterns.mdrequirements-definition.mdrpi-research-integration.mdsmart-rubric.mdstakeholder-analysis.mdstandards-excerpts.mdtraceability-matrix.mdtraceability-naming.mdreferences/brd/brd-quality-formats.mdbrd-quality-report-v1.mdbrd-standard-findings-v1.mdbrd-to-prd-handoff-v1.mdhandoff-payload-schema.mdiso-25010-nfr-taxonomy.mdiso-29148-quality-gate.mdistqb-testability.mdoutcome-hypothesis-to-brd-handoff-v1.mdrequirements-quality-rubric.mdreferences/prd/connextra-template.md詳細
要件作成スキル
概要
このスキルでは、プロジェクトのライフサイクル全体で、ビジネス要件定義書(BRD)と製品要件定義書(PRD)の2種類の文書を作成し、発展させる方法を定義します。要件エンジニアリングに関する共通の知識は references/_shared/ にあり、BRD固有およびPRD固有の知識は references/brd/ と references/prd/ にあります。それぞれの文書を扱うエージェントは、必要な内容のみを読み込みます。
標準BRDテンプレートは brd-full.md とその brd-frontmatter-overlay.md で、標準PRDテンプレートは prd-full.md です。BRD BuilderはBRDフェーズのアンカー(#discover、#define、#govern)に振り分け、PRD BuilderはPRDフェーズのアンカー(#prd-assess から #prd-finalize まで)に振り分けます。
このスキルは、作業対象の文書に対応する参照資料と併せて使用してください。
共通(references/_shared/):
BRD の対象範囲(references/brd/):
PRD の対象範囲(references/prd/):
引き継ぎの受け渡し規約
引き継ぎごとの標準的な受け渡し方法は、生成するワークフローが定めます。受け取る側は、受け渡し方法にかかわらず、ペイロード全体を検証します。成果仮説では、すでに永続化されたソース成果物から導出する一度限りのシードであるため、既定では OUTCOME_HYPOTHESIS_TO_BRD_HANDOFF_V1 をインラインで返します。ユーザーは代わりに、別途永続化されたペイロードのパスを指定することもできます。BRD Governでは BRD_TO_PRD_HANDOFF_V1 を永続化し、そのペイロードはエージェントセッションをまたいで利用される永続的なガバナンス記録であるため、そのパスを返します。この非対称性は意図的なものであり、ペイロードの権限や検証方法に変更はありません。
BRD のライフサイクル
| フェーズ | 主な目的 | 開始条件 | 完了条件 |
|---|---|---|---|
| Discover | ビジネスの背景、ステークホルダーの範囲、課題の枠組みを明確にする | 依頼または取り組みが受付中である | Discover のハードゲートを通過し、成果物が揃っている |
| Define | 完全で、テスト可能かつトレーサブルな要件を作成する | Discover の成果物が詳細化の承認を受けている | 品質を裏付ける証拠とともに、Define のハードゲートを通過する |
| Govern | 系譜管理のもとで BRD のバージョンを最終化し、承認し、後続バージョンに置き換える | Define のパッケージがガバナンスレビューの承認を受けている | Govern のハードゲートを通過し、公開成果物が記録されている |
Discover {#discover}
アクティビティ
- ビジネスの背景、推進要因、課された制約、期待される成果を把握します。
- ステークホルダー、意思決定者、レビュー参加者を特定します。
- 対象範囲の境界、前提条件、依存関係の範囲を定義します。
- 初期要件候補を作成し、トレーサビリティの仮置き項目を早期に対応付けます。
OUTCOME_HYPOTHESIS_TO_BRD_HANDOFF_V1ペイロードが提供された場合は、検証して処置を決定します。
成果仮説の受け入れ
正規の契約として成果仮説から BRD への引き継ぎを使用します。
- YAML をインラインで受け取るか、ユーザーが指定したアーティファクトパスから受け取ります。
- 値を BRD にコピーする前に、ペイロード全体を検証します。
- サポートされていないバージョン、不完全なシード、プレースホルダー値、無効な出所情報は拒否します。拒否したペイロードを非構造化された根拠として再解釈してはなりません。
- 次の安定した
BG-###識別子を割り当てます。 - ステートメント、KPI、ベースライン、目標、期間、測定元、担当者の各値を個別に記録します。
- 各シードフィールドを
acceptedまたはrevisedとしてマークします。修正する場合は、元の値、現在の BRD の値、理由を保持します。 - 前提条件と未解決の質問を、正規の BRD セクションにマッピングします。Discover が BRD で管理する別のステータスを明示的に確認しない限り、インポートした各質問は
Openに初期化します。先送りする質問にはすべて、先送りの理由と、PRD、Implementation、Operations、Future-Releaseのいずれかの対象フェーズが必要です。 - 引き継ぎ ID、ソースパス、ソースの SHA-256、KPI の測定元を BRD の出所情報レシートに記録します。
Discover が引き継ぎを受け入れるまでは、検証済みのペイロードをインポートしたシード値の正とします。Discover はそれらの値を明示的に受け入れるか、修正できます。Discover の終了後は BRD を正とします。その後に仮説を変更する場合は、新たに検証済みのペイロードを用意し、Discover に明示的に再参加させる必要があります。
終了の必須ゲート
Discover は、以下を満たした場合にのみ終了します。
- スコープが限定され、ステークホルダーの担当が明確になっていること。
- 中核となる前提条件と制約が文書化され、レビュー可能であること。
- Define に必要なシードアーティファクトが揃い、相互に整合していること。
- 成果仮説の引き継ぎがある場合、検証に合格しており、インポートしたすべてのシードフィールドに明示的な処置が指定され、出所情報レシートが完成していること。
出力アーティファクト
- Discover の概要とスコープステートメント。
- 役割と担当の対応付けを含むステークホルダー一覧。
- 初期の前提条件・制約の一覧。
- Define 用のシード要件とトレーサビリティのひな形。
- 引き継ぎが提供された場合は、成果仮説レシートと各フィールドの処置。
Define {#define}
アクティビティ
- brd-full.md と正規の命名規則を使用して、BRD の全内容を作成します。
- 明確な受け入れ意図に基づいて、ビジネス目標と要件セットを精緻化します。
- 作成者が管理する FR、AC、BG、BR 間のトレーサビリティリンクを構築し、検証します。
- BRD の品質レポート契約に基づいて品質評価を実施します。
終了の必須ゲート
Define は、以下を満たした場合にのみ終了します。
- 要件の内容が完全で、曖昧さがなく、テスト可能であること。
- トレーサビリティリンクが、有効な ID スキーマと命名ポリシーを満たしていること。
- FR-to-AC カバレッジが、有効な
fr_to_ac_coverage_threshold_pctを満たしているか、ブロッカーが記録されていること。 - 品質に関する指摘事項が生成され、定義済みの評価基準に照らしてレビューされていること。
出力アーティファクト
- 構造化されたセクションを含む BRD 全体のドラフトパッケージ。
- 命名規則と ID 規則に準拠した、作成者が管理するトレーサビリティマトリクス。
- BRD の品質に関する指摘事項と、統合された品質レポートのペイロード。
- レビュアーの注記を含む Define ゲートの判断記録。
Govern {#govern}
アクティビティ
- バージョンメタデータと系譜フィールドを含め、最終承認用の BRD を準備します。
- 承認済み BRD のドラフトバージョン
0.x.yを1.0.0以上に引き上げます。 - 残っている品質に関する指摘事項を解決するか、処置を決定します。
- 承認済みの BRD 出力と、後続工程への引き継ぎペイロードを公開します。
- BRD を置き換える新しいバージョンを発行する際は、置き換えの連鎖を維持します。
引き継ぎの生成を管理する
BRD_TO_PRD_HANDOFF_V1 を出力する前に、BRD Builder は BRD-to-PRD Handoff の網羅性および免除の検証ルールを適用します。これには、FR カバレッジがゼロの場合の処理も含まれます。承認済みの BRD と最終品質レビューから、次の値を記録します。
- 承認時点における BRD 成果物の正確なバイト列の小文字 SHA-256 ハッシュ。
- id-schema.md に基づく FR、NFR、BR、CON、AC、BG の各識別子の数。
- 作成者が管理するトレーサビリティマトリックスに基づく、FR と AC、および FR と BG のカバレッジ指標。
- 最終版の
BRD_QUALITY_REPORT_V1参照、全体ステータス、Govern の決定。 - 承認者、役割、決定、承認タイムスタンプ、コメント、有効な免除。
- 承認済みの FR-to-AC しきい値の不足または FR-to-BG 目標の不足に関する免除記録。
検証に成功したら、完全な YAML ペイロードを .copilot-tracking/brd-sessions/<brd-name>.handoff.yml に書き込み、そのパスを BRD セッションの状態に記録し、簡潔な Govern の概要とともにパスを返します。後続の転送にインラインのチャットペイロードを使用しないでください。
必須の終了ゲート
次の条件を満たした場合にのみ、Govern を終了します。
- 承認ステータスと必要なレビュアーが記録されている。
- バージョンと系譜のメタデータが有効かつ完全である。
- 最終品質レポートが Govern の終了を承認している。
- 後続の利用者向けに引き継ぎ成果物が公開されている。
出力成果物
- 承認済みの BRD リリース成果物。
- BRD-to-PRD 引き継ぎペイロード。
- 承認の証拠を含むガバナンス決定ログ。
- 置き換えられた BRD バージョンの後継関係記録。
ステータス分類
BRD ライフサイクルの追跡には、次のステータス値を使用します。
draft:作成または改訂中です。in-review:正式なレビューとゲート検証の対象です。approved:ガバナンス対象としての使用が承認されています。superseded:新しい承認済み BRD に置き換えられています。
品質評価基準への参照
BRD Quality Formats の BRD 品質評価基準とペイロード仕様を、Requirements Definition のガイダンスと併せて適用します。評価基準の結果は、Define と Govern の決定におけるゲートの証拠として扱います。BRD Quality Reviewer は、標準的な指摘事項と統合品質レポートの両方を出力します。
後継関係の系譜ルール
- スコープが統合される場合、BRD はそれ以前の 1 つ以上の BRD を置き換えることができます。
- 1 つの BRD を置き換える承認済みの後継バージョンは 1 つだけです。
- すべての置き換えイベントで、
supersedesとsuperseded_byのリンクを記録します。 - 置き換え後も、監査可能性を保つために過去の成果物を保持します。
PRD ライフサイクル
PRD Builder エージェントは、7 フェーズのライフサイクルを実行します。各フェーズには以下にセクションアンカーがあり、エージェントは現在のフェーズに関するガイダンスのみを読み込みます。
| フェーズ | セクションアンカー | 主な目的 |
|---|---|---|
| 評価 | #prd-assess | PRD ファイルを作成するためのコンテキストが十分にあるか判断します。 |
| 発見 | #prd-discover | PRD のタイトル、スコープ、製品目標を定めます。 |
| 作成 | #prd-create | コンテキストが明確になった時点で、PRD ファイルと状態ファイルを生成します。 |
| 構築 | #prd-build | 詳細な要件を段階的に収集します。 |
| 統合 | #prd-integrate | 参照資料、文書、外部資料を取り込みます。 |
| 検証 | #prd-validate | 承認前に完全性と品質を確認します。 |
| 最終化 | #prd-finalize | 完全で、実行に移せる PRD を提出します。 |
PRD の評価 {#prd-assess}
アクティビティ
- PRD 成果物を作成するのに十分なプロダクトコンテキストがあるかどうかを判断します。
- イニシアチブ、問題の説明、主要なターゲットユーザーを特定します。
- 上流の
BRD_TO_PRD_HANDOFF_V1成果物のパスを確認し、存在する場合は、その網羅範囲と免除に関するコンテキストを取り込みます。 - 上流の実現可能性から PRD へのハンドオフを確認します。
kindで識別し、必須メタデータと判定フィールドの有無、読み取り可能なワークスペース相対の調査パスを検証するには、実現可能性から PRD へのハンドオフに従います。実現可能性は補足的なエビデンスとして扱い、承認済みの BRD スコープを維持します。 - 新しいセッションでは、Create が状態ファイルを書き込むまで、Assess の出力にハンドオフの種類、パス、取り込み日時、判定、調査のリビジョン識別子を引き継ぎます。状態がすでに存在する場合は、実現可能性固有のメタデータオブジェクトを直接更新します。未加工の候補コンテンツはハンドオフ成果物に保持します。
- 追加のコンテキストを収集するか、ファイル作成に進むかを判断します。
強制終了ゲート
Assess は、次の条件を満たした場合にのみ終了します。
- 意味のあるケバブケースの PRD 名を導出できること。
- 問題の枠組みと主要ユーザーが特定されていること。
- 利用可能な BRD ハンドオフ成果物があれば、その内容が読み込まれ、ペイロードが検証され、網羅率の指標が記録されていること。
- 利用可能な実現可能性ハンドオフがあれば、
kindで識別され、ワークスペース相対の読み取り可能なパスを持ち、有効な判定の形式を備え、正規化されたメタデータが Create 用に準備されているか、既存の状態に保存されていること。
出力成果物
- コンテキストが十分かどうかを記した Assess の要約。
- PRD の導出された作業タイトル。
- BRD ハンドオフのペイロードがある場合は、取り込んだハンドオフコンテキスト。
- 実現可能性ハンドオフがある場合は、判定、エビデンスの要約、制約、ギャップ、正規化されたハンドオフメタデータ。否定的な判定の場合、候補の処遇は作成されません。
PRD Discover {#prd-discover}
アクティビティ
- PRD のタイトル、スコープ、プロダクトの目標を明確にするため、焦点を絞った質問をします。
- プロダクトディスカバリーとMVP の枠組みを使って、問題領域を探索します。
- 指標フレームワークを使って、ターゲットユーザー、成功指標の候補、明示的な非目標を記録します。
強制終了ゲート
Discover は、次の条件を満たした場合にのみ終了します。
- タイトルとスコープが明確であること。
- 主要ユーザーと成功指標の候補が明記されていること。
- 対象範囲内と対象範囲外の境界が記録されていること。
出力成果物
- ディスカバリーの要約。
- スコープと非目標に関する記述。
- 成功指標の候補。
PRD Create {#prd-create}
アクティビティ
- prd-full.mdから PRD ファイルを生成し、タイトルとコンテキストが明確になった時点でセッション状態ファイルを作成します。
- 確立されたスコープ、ユーザー、目標をテンプレートに反映します。
- Build に向けて、反復的な要件と指標の構成を準備します。
- Assess が正規化済みの実現可能性メタデータを生成した場合は、
kind、path、ingestedAt、verdict、studyRevisionIdを引き継ぎ、そのフィールドを新しい状態ファイルにfeasibilityHandoffとしてアトミックに書き込みます。この仕様より前に書き込まれた状態には、kindの代わりにschemaVersionが含まれる場合があります。その状態をエラーなく読み込み、次回の実現可能性メタデータ更新時にオブジェクトを現在の形式に書き換えます。未加工の候補コンテンツは保存しないでください。
強制終了ゲート
Create は、次の条件を満たした場合にのみ終了します。
- PRD ファイルと状態ファイルが存在すること。
- テンプレートの骨格が標準の PRD 構成に一致していること。
- 初期スコープと目標が設定されていること。
- Assess で正規化された実現可能性メタデータがある場合、Build の開始前に新規作成した状態ファイルに含まれていること。
出力成果物
- PRD ドラフトの骨格。
- PRD セッション状態ファイル。
- 設定済みのスコープと目標のセクション。
- 提供された場合は、保存済みの実現可能性ハンドオフメタデータ。
PRD Build {#prd-build}
アクティビティ
- 詳細な機能要件および非機能要件を反復的に収集します。
feasibilityHandoffが存在する場合は、ワークスペース相対パスから候補の内容を読み込みます。取り込み済みと報告されているにもかかわらずメタデータがない場合、またはパスを読み取れない場合は停止します。- 前向き判定の実現可能性候補にはそれぞれ、PRD が管理する処置を1つだけ割り当てます:
accepted-fr、accepted-nfr、accepted-constraint、retained-gap、rejected、またはdeferred。懸念事項のヒントは、あくまで参考証拠として扱います。 - 最終的な
FR-###、NFR-###、またはCON-###の識別子は、PRD の記述を作成して承認した後にのみ割り当てます。「Feasibility Candidate Disposition register」には、ソースのハンドオフ ID、ソースの候補 ID、証拠への参照、処置、根拠、および結果として得られた PRD ID を記録します。 - 承認済み BRD の権限を維持します。BRD と実現可能性の間の矛盾を記録して明示的に解決するか、現時点の証拠では責任ある解決ができない場合は、Build のギャップとして残します。
- EARS Acceptance と Connextra Template を使用して受け入れ基準を作成します。
- NIST 800-160 NFR taxonomy を使用して非機能要件を分類し、ストーリーを INVEST に照らして確認します。
- Traceability Naming、Traceability Matrix、および id-schema.md を使用して、要件、目標、メトリクス間の作成者によるトレーサビリティを維持します。
強制終了ゲート
次の場合にのみ Build を終了します:
- 要件が完全で、テスト可能であり、追跡可能である。
- 受け入れ基準が EARS 形式または Given-When-Then 形式に従っている。
- 非機能要件が分類されている。
- カバレッジが適用中のしきい値を満たしているか、ブロッカーが記録されている。
- 前向き判定の実現可能性候補すべてに、処置を記載した行が1行ずつあり、承認された行には最終 PRD ID が記載されており、否定的な判定には候補の行がない。
成果物
- PRD 要件一式。
- 作成者が管理するトレーサビリティマトリクス。
- 受け入れ基準と NFR 分類。
- 前向きの実現可能性ハンドオフがある場合は、「Feasibility Candidate Disposition register」。
PRD Integrate {#prd-integrate}
アクティビティ
- ユーザー提供の参考資料、文書、および外部資料を取り込みます。
- 受け取った内容を既存の要件と照合し、矛盾を解決します。
- 要件およびメトリクスに裏付けとなる証拠をリンクします。
強制終了ゲート
次の場合にのみ Integrate を終了します:
- 提供された参考資料が取り込まれているか、明示的に保留されている。
- ソース間の矛盾が解決されている。
- 裏付けとなる証拠がリンクされている。
成果物
- 参考資料を統合した PRD セクションの更新版。
- 参考資料と証拠のリンク記録。
PRD Validate {#prd-validate}
アクティビティ
- 承認前に完全性と品質を評価します。
- PRD Quality Formats に従って PRD Quality Reviewer を実行し、
PRD_STANDARD_FINDINGS_V1およびPRD_QUALITY_REPORT_V1を出力します。 - ルーブリックに照らして指摘事項を確認し、ギャップを解決するか、処置を記録します。
強制終了ゲート
次の場合にのみ Validate を終了します:
- 品質に関する指摘事項と統合レポートが生成されている。
- レポートが
gate_decisions.validate_exitを通じて Validate の終了を許可している。 - カバレッジと品質のしきい値が満たされているか、免除されている。
成果物
- PRD 品質に関する指摘事項とレポートのペイロード。
- Validate ゲートの決定記録。
PRD Finalize {#prd-finalize}
アクティビティ
- 完全で実行可能な PRD を提供します。
- 残る指摘事項を解決し、バージョンと承認のメタデータを記録します。
- Finalize の差分チェックを実行し、後続の成果物を公開します。
強制終了ゲート
次の場合にのみ Finalize を終了します:
- 承認ステータスと必須レビュアーが記録されている。
- 最終品質レポートが
gate_decisions.finalize_exitを通じて Finalize の終了を許可している。 - 未解決のブロッキング指摘事項が残っていない。
出力成果物
- 承認済み PRD リリース成果物。
- 承認エビデンスを含む最終決定ログ。
参照
このスキルは references/ 配下に参照ドキュメントをバンドルしており、3 つのスコープに整理されています。共有の要件エンジニアリング知識は references/_shared/、BRD 固有の知識は references/brd/、PRD 固有の知識は references/prd/ にあります。参照本文は、そのフェーズのアクティビティで必要な場合にのみ読み込んでください。各本文は、それぞれ独自のサブ参照(標準へのポインター、スコアリングシート、実例)にリンクしています。
共有参照 (references/_shared/)
- requirements-definition.md - 要件カテゴリ、正規の記述形式、受け入れ基準の形式、品質の観点。
- stakeholder-analysis.md - Mendelow の Power/Interest グリッドと RACI の責任バリエーション。
- process-modeling.md - 任意のプロセス図、決定図、構造図のガイダンス。
- prioritization-schemes.md - 必須の MoSCoW 優先順位付けスキーム。
- traceability-naming.md - 要件、目標、決定の識別子ルーティングとトレーサビリティの慣例。
- id-schema.md - 正規のプレフィックス、桁数、隣接識別子のルール。
- traceability-matrix.md - 作成者が管理する FR から AC、FR から BG、BR から FR へのマトリックスビュー。
- design-decisions.md -
DD-###設計決定コードのレジストリ。 - quality-rubric.md - 運用ステータスの分類体系(
RISK/CAUTION/COVERED/NOT_APPLICABLE)とゲート判定ルール。 - standards-excerpts.md - 名前で参照されるサードパーティ標準(ISO、IIBA、PMI、ISTQB)の引用専用レジストリ。
BRD 参照 (references/brd/)
- brd-quality-formats.md - BRD データコントラクトのプロデューサーとコンシューマーのマップ。
- requirements-quality-rubric.md - 要件単位、NFR カテゴリ単位、ビジネスゴール単位のスコアリングシートを統合したもの。
- handoff-payload-schema.md - BRD から PRD へのハンドオフペイロードの BRD 作成者ビュー。
PRD 参照 (references/prd/)
- product-discovery.md - PRD スコープのための問題空間の探索とディスカバリーの問いかけ。
- mvp-framing.md - MVP のフレーミングとスコープ境界のガイダンス。
- metrics-frameworks.md - JTBD、HEART、AARRR の成功指標フレームワーク。
- ears-acceptance.md - PRD 要件のための EARS 受け入れ基準パターン。
- nist-800-160-nfr.md - NIST 800-160 非機能要件の分類体系。
- invest.md - ユーザーストーリーのための INVEST 品質基準。
- connextra-template.md - Connextra ユーザーストーリーテンプレート。
- prd-quality-formats.md - PRD データコントラクトのプロデューサーとコンシューマーのマップ。
- feasibility-to-prd-handoff.md - 実現可能性 Assess の取り込み、Create の永続化、Build の処分、BRD の共存、ソースのトレーサビリティに関するコンシューマールール。
テンプレート
templates/ 配下のテンプレートは、ドキュメントのフロントマターと標準的なドキュメント構成によって選択されます。
- brd-full.md - エグゼクティブサマリーから承認まで、すべてのセクションを網羅する標準的な BRD テンプレートです。
- brd-frontmatter-overlay.md -
diagram_format、系譜、カバレッジのしきい値、要件プレフィックスの上書きを含む、BRD YAML フロントマターのスキーマです。 - diagram-mermaid.md - Mermaid フローチャートの断片です。デフォルトの図形式です。
- diagram-ascii.md - 解像度の低い Discover フェーズのスケッチ向けの ASCII プロセス図の断片です。
- prd-full.md - 製品概要から受け入れ条件およびメトリクスまで、すべてのセクションを網羅する標準的な PRD テンプレートです。
データコントラクト
ペイロードコントラクトは、各ドキュメントタイプの品質評価と後続の引き継ぎを規定します。品質ペイロードと BRD の引き継ぎペイロードには固定の schema_version が含まれます。コンシューマーはそれ以外の値を受け取ると即座に失敗するため、これらの定数を変更してはなりません。実現可能性から PRD への引き継ぎには、プレーンな kind マーカーが含まれます。これは、生成側と消費側が同時にリリースされ、バージョン交渉が適用されないためです。
BRD データコントラクト:
| コントラクト | schema_version | リファレンス |
|---|---|---|
| 標準調査結果 | BRD_STANDARD_FINDINGS_V1 | brd-standard-findings-v1.md |
| 品質レポート | BRD_QUALITY_REPORT_V1 | brd-quality-report-v1.md |
| BRD から PRD への引き継ぎ | BRD_TO_PRD_HANDOFF_V1 | brd-to-prd-handoff-v1.md |
PRD データコントラクト:
| コントラクト | schema_version | リファレンス |
|---|---|---|
| 標準調査結果 | PRD_STANDARD_FINDINGS_V1 | prd-standard-findings-v1.md |
| 品質レポート | PRD_QUALITY_REPORT_V1 | prd-quality-report-v1.md |
上流 PRD 入力コントラクト:
| コントラクト | 識別子 | リファレンス |
|---|---|---|
| BRD から PRD への引き継ぎ | schema_version: BRD_TO_PRD_HANDOFF_V1 | brd-to-prd-handoff-v1.md |
| 実現可能性から PRD への引き継ぎ | kind: feasibility-to-prd-handoff | feasibility-to-prd-handoff.md |
PRD のライフサイクルでは、Assess 中に両方の上流コントラクトを使用します。BRD 入力は、承認済みのビジネスコンテキスト、カバレッジ、免除事項を提供します。実現可能性入力は、確認済みの判定、証拠、制約、ギャップ、PRD Build 向けの提案候補を提供します。どちらのコントラクトも、PRD の作成を省略するものではありません。
必須の読み込み指示
BRD Builder エージェントと PRD Builder エージェントには、それぞれフェーズ → セクションの読み込み契約が適用されます。各フェーズでは、フェーズ作業を実行する前に、このスキルの該当セクションを必ず読み込み、セクションアンカーを state.phaseSkillsLoaded に追加する必要があります。
BRD Builder の指示:
| フェーズ | セクションアンカー | 必須の phaseSkillsLoaded エントリ |
|---|---|---|
| Discover | #discover | brd-author#discover |
| Define | #define | brd-author#define |
| Govern | #govern | brd-author#govern |
PRD Builder の指示:
| フェーズ | セクションアンカー | 必須の phaseSkillsLoaded エントリ |
|---|---|---|
| Assess | #prd-assess | prd-author#assess |
| Discover | #prd-discover | prd-author#discover |
| Create | #prd-create | prd-author#create |
| Build | #prd-build | prd-author#build |
| Integrate | #prd-integrate | prd-author#integrate |
| Validate | #prd-validate | prd-author#validate |
| Finalize | #prd-finalize | prd-author#finalize |
エージェントは、このスキルファイルに対して read_file を実行してセクションを読み込み、フェーズ作業を実行する前にエントリを state.phaseSkillsLoaded に記録します。phaseSkillsLoaded は永続的な読み込み履歴であり、ガイダンスが現在のモデルコンテキストに存在することを示すものではありません。同じライブコンテキスト内で、すでにセクションを読み込んだフェーズに再び入る場合、再読み込みは不要です。コールドスタート、再開、またはコンテキストの要約後は、エントリが記録されていても、エージェントは現在のフェーズのセクションを再読み込みします。
出典の帰属
同梱の参考資料本文は、第三者の標準規格やフレームワークを名称と条項番号のみで引用しており、原典の文章を複製または言い換えていません。参考資料で標準規格の特性や分類に言及する場合、併記されたレビュー基準、アンカー、指標は、標準規格の定義を複製したものではなく、CC BY 4.0 に基づく Microsoft のオリジナルコンテンツです。正式な定義は、引用された標準規格に記載されています。standards-excerpts.md にある引用のみのレジストリは、新たな標準規格の引用を追加する唯一の場所です。名称を挙げて参照している標準規格には、ISO/IEC/IEEE 29148:2018、ISO/IEC 25010:2023、IIBA BABOK v3、PMI Business Analysis for Practitioners、ISTQB Glossary、OMG BPMN / DMN / UML、Cucumber Gherkin パターン、MoSCoW 優先順位付けが含まれ、それぞれの権利者が所有しています。
ライセンス
このスキルは Microsoft のオリジナルコンテンツであり、CC BY 4.0 に基づいてライセンスされています。