プラットフォームPRDビルダー は何をしますか?
このスキルを使用して、大まかなインプットを構造化され、実装可能なプロダクト要件に変換します。単に翻訳するのではなく、内容を理解し、再構成し、充実させ、正確なスコープを維持してください。
動作モード
リクエストを満たす最も軽量なモードを選択してください:
- フルPRDビルド:複雑な、または複数システムにまたがる要件に対して完全なPRDを作成します。
- セクションビルド:背景、スコープ、フロー、API/データ変更、ロールアウトなど、リクエストされたセクションのみを作成します。
- リライト / ポリッシュ:意思決定を変更せずに、構造、明瞭さ、英語、またはバイリンガルの表現を改善します。
- インプット正規化:散在するメモを、確定した決定事項、アサンプション、未決定事項、およびエンジニアリングが読める言語に変換してからドラフトを作成します。
- テンプレート選択:リクエストが必ずしも完全なPRDでない場合に、適切な成果物タイプを選択します。
- 方向性アライメント案:完全なPRDに展開する前に、軽量なコンセプト/アライメントバージョンを作成します。
最初のアクション
以下を簡潔に特定します:
- ビジネスシナリオ
- プラットフォーム機能
- 関連システム
- 現在のフェーズと対象外事項
- 成果物タイプ:フルPRD、PRDセクション、1ページBRD、バイリンガルドラフト、英語リライト、テーブル、フロー説明
ユーザーが影響や実現可能性のみを尋ねている場合は、まだPRDを作成せず、最初に影響分析を使用します。
成果物タイプが不明な場合は、最も小さな有用な成果物を提案し、その選択が納品リスクを生じさせない限り続行します。
ステップ0:ステージ検出
ドラフトを作成する前に、ユーザーのステージを分類します:
- アイデアのみ:最初に方向性アライメント案を作成します。
- 散在メモ:最初に決定事項、アサンプション、未決定事項を正規化します。
- スコープ未確定:現在のフェーズの要件を作成する前に、
platform-scope-checkerにルーティングします。 - 作成準備完了:リクエストされたPRDまたはセクションを作成します。
- 既存ドラフトあり:構造を改善するか、ユーザーがフィードバックを希望する場合は
platform-prd-reviewerにルーティングします。 - RFC詳細リクエスト:PRD内では製品のセマンティクスを維持し、実装の詳細はエンジニアリングフォローアップにルーティングします。
ビルドチャレンジゲート
リクエストをビルド主体のPRDに変換する前に、同じビジネス目標を以下で達成できないか簡単に検討します:
- 既存のプラットフォーム機能
- 設定
- 運用プロセスまたは一時的な手動処理
- より小規模なワークフロー変更
- 段階的ロールアウト
- 現在のフェーズの完全な動作を実装しない互換性プレースホルダー
答えが不明確であるか、ビルドリスクが高い場合は、完全なPRDを作成する前にスコープチェックを推奨します。
二段階納品
曖昧な要件、0-to-1の要件、または大規模な複数システム要件については、二段階を推奨します:
- 方向性アライメント案:問題、ターゲットユーザー/オペレーター、プラットフォーム機能、スコープ境界、コアフロー、オーナーシップ、アサンプション、未決定事項。
- 詳細PRD:システム別要件、フィールド/API/データ変更、状態/エッジケース、ロールアウト/運用、受け入れ基準、リスク。
コアとなる製品の方向性、MVPの境界、または信頼できる情報源がまだ確定していない場合は、詳細PRDに飛びつかないでください。
使用すべきでない場合
以下の場合、このスキルを最初のアクションとして使用しないでください:
- ビジネス上の問題やターゲットユーザーがまだ議論中である場合。最初に
platform-product-guideで方向性を明確にします。 - 質問が「これを今やるべきか?」である場合。最初に
platform-scope-checkerを使用します。 - ユーザーが既存の成果物に対してレビューフィードバックのみを希望している場合。
platform-prd-reviewerを使用します。 - リクエストが純粋なエンジニアリングRFC、コード設計、実装計画であり、製品要件の作業が含まれていない場合。
PMインプット正規化ツール
インプットが曖昧で、技術的でない、または散在メモとして書かれている場合、ドラフトを作成する前に、まずエンジニアリングが読める製品決定事項に変換します。ユーザーに技術用語の使用を要求しないでください。
決定事項が不足している場合は、この軽量な出力を使用します:
確定した決定事項
- ...
不足している決定事項
- ...
エンジニアリング関連翻訳
- 「承認記録が必要」は、監査ログフィールド、書き込みタイミング、クエリアクセス、保存期間に関する決定事項が必要であることを意味します。
- 「別のシステムに通知する」は、コールバックタイミング、リトライ、タイムアウト、障害処理、ステータス整合性に関する決定事項が必要であることを意味します。
技術的なラベルの質問ではなく、ビジネス言語の質問をします:
- 「冪等性キーは何ですか?」の代わりに、「同じリクエストが2回送信された場合、システムは新しいレコードを作成しますか、拒否しますか、それとも既存のレコードを返しますか?」
- 「コールバックリトライ戦略は?」の代わりに、「受信システムに通知できない場合、ユーザーには何が表示され、誰が修正し、どの程度の期間未解決のままにできますか?」
- 「信頼できる情報源は誰ですか?」の代わりに、「2つのシステムが異なるステータスを示している場合、どちらを信頼すべきですか?」
- 「互換性戦略は?」の代わりに、「リリース後、既存のレコードや進行中のプロセスに影響がありますか?」
- 「ステートマシンを定義してください」の代わりに、「このリクエストは作成から完了までどのようなステータスを取り得、各ステータスでどのようなアクションが許可されていますか?」
アサンプションとエビデンス台帳
大まかなメモから重要な決定事項が推測された場合、最終決定前にそれらを明らかにします:
アサンプション
- A1:...
エビデンス / ソース
- E1:ユーザーのメモ / プロトタイプ / 過去のPRD / 会議メモ / 明示的な指示から
確認が必要
- C1:...
アサンプションを黙って要件に変換しないでください。ユーザーが続行を要求した場合、未解決の項目は、所有者/依存関係が判明している場合はそれらと共に、未解決質問として残します。
テンプレート選択
1つの重い構造を強制するのではなく、成果物タイプに応じてテンプレートを選択します。
短機能PRD:
- 背景
- 目的
- スコープ
- 要件
- API / データ変更
- エッジケース
- 添付資料 / リンク
API / フィールド変更ノート:
- 背景
- 変更されたコントラクト
- フィールドテーブル
- バリデーション / デフォルト動作
- 後方互換性
- ダウンストリームコンシューマー
- 例
設定UI PRD:
- 背景
- 目標
- ページパス / エントリー
- 一覧フィールド
- フィルター / クエリ動作
- 作成 / 編集動作
- バリデーションルール
- 権限 / 監査
- 添付資料 / プロトタイプ
移行PRD:
- 背景
- スコープ
- ソース / ターゲットシステム
- 移行フロー
- データマッピング
- バリデーション / 調整チェックリスト
- カットオーバー / ロールバック
- 未解決質問
計算式 / ルールロジックPRD:
- 背景
- ルール形式
- フィールド定義
- 処理ロジック
- 例
- エッジケース
- 後方互換性
デフォルトPRD構造
ユーザーが別のテンプレートを指定しない限り、この構造を使用します:
- 背景
- 目標
- スコープ
- アクター / システム
- 全体フロー
- フロー詳細
- システム別要件
- API / データ変更
- シナリオ & エッジケース
- ロールアウト / 運用
- 未解決質問
- 依存関係 / リスク
短いセクションの場合は、関連する見出しのみを使用しますが、同じ思考順序を維持します。
プラットフォームフローモデラーを使用すべき場合
platform-flow-modelerを使用してから、全体フロー、フロー詳細、シナリオ & エッジケース、状態遷移、または運用セクションを作成します。これは、要件が3つ以上のシステムを含む、ライフサイクル/ステータス変更、コールバック/リトライ/タイムアウト、ロールバック/キャンセル/再送信、調整、決済、移行、手動フォールバックを含む場合です。
最初にフローテーブルを作成させ、次にそれらのテーブルをPRDの散文、システム別要件、シナリオ、受け入れ基準、未解決質問に変換します。
出力契約
すべてのPRDスタイルの出力は、以下の事項をテスト可能にする必要があります:
- 問題と「なぜ今なのか」
- 現在のフェーズの目標
- スコープ境界
- メインフローと主要な例外フロー
- まだ未解決の製品決定事項
- 受け入れ基準またはシナリオマトリックス
- システム間動作のオーナー/信頼できる情報源
- 必要に応じて、ロールアウト、ロールバック、または一時的な手動処理
デフォルトのレスポンス形状:
- 選択した成果物タイプに関する簡単なメモ(有用な場合)
- 作成されたPRDコンテンツまたはリクエストされたセクション
- アサンプションと未決定事項(ある場合)
- 推奨される次のレビュールート:スコープチェック、PRDレビュー、RFCフォローアップ、またはステークホルダー確認
このスキルは、アドバイスだけでなく成果物を生成する必要があります。成果物を安全に生成できない場合は、不足している決定事項の台帳と次のアクションを出力します。
詳細なPRDテンプレートと成果物固有の出力契約については、タスクがフルPRD、0-to-1プラットフォームPRD、移行PRD、設定UI PRD、またはAPI/データ変更ノートを含む場合に、references/prd-output-contract.mdを参照してください。
シナリオ & 受け入れ基準
シナリオ & エッジケースセクションでは、QAとエンジニアリングの連携を改善するために、Given/When/Then形式の受け入れ基準を使用します:
**シナリオ:[名前]**
- **Given:** [前提条件:システム状態、アクター、データ、設定]
- **When:** [トリガーアクション]
- **Then:** [期待される結果:最終ステータス、ユーザー/運用担当者が確認できる結果、ダウンストリーム同期、監査記録]
必要に応じて、以下のシナリオタイプをカバーします:
- ハッピーパス
- バリデーション失敗:フィールド欠落、無効な値、重複送信
- ダウンストリームシステム障害:コールバックタイムアウト、APIエラー、部分障害
- 同時または重複送信
- ステータス遷移エッジケース:終端状態からの再送信、フロー途中のキャンセル
- ロールバックまたはリバース
- 手動フォールバック:運用担当者による介入または例外キューエントリー
- 権限境界:アクターが許可されていない、またはソースシステムの不一致
各Then句をテスト可能にします。最終ステータス、ユーザー/運用担当者が確認できる結果、ダウンストリームシステムへの通知有無、監査/イベントレコードの作成有無を明記します。
シナリオマトリックスが大きくなる場合は、コンパクトなテーブルを使用します:
| シナリオ | 前提条件 | トリガー | 最終ステータス | ユーザー/運用結果 | ダウンストリーム | 監査 |
|---|---|---|---|---|---|---|
API / データテーブルスタイル
APIまたはデータ変更には、以下の項目を含むテーブルをデフォルトとします:
- フィールド
- データ型 / タイプ
- 必須
- 値 / バリデーション
- 説明
- 例
- 変更タイプ:新規 / 既存 / 削除(該当する場合)
- オーナー / コンシューマー(オーナーシップが重要な場合)
0-to-1 プラットフォームPRD追加事項
新しいプラットフォーム/インフラストラクチャ機能については、以下を追加します:
- プラットフォームの方向性と設計原則
- 設定オブジェクトとランタイムオブジェクト
- オーナーシップ/信頼できる情報源テーブル
- ライフサイクル/ステートマシン
- バージョニングとスナップショット動作
- コールバック、リトライ、タイムアウト、冪等性の動作
- 監査/イベントログ記録
- 権限とソースシステムの分離
- MVPの対象外事項と将来のイテレーション
- 役割、データスコープ、運用リージョンごとのUI/ワークスペースモデル
記述ルール
- 英語出力が要求された場合は、大まかなメモをプロフェッショナルな英語に変換します。
- 実際のシステム名やチームの成果物を反映している場合は、中国語/英語の混合用語を維持します。
- 読者が理解して実装するために必要な説明を追加しますが、ビジネス上の決定事項をでっち上げないでください。
- インプットの品質にばらつきがある場合は、最終的なPRDを作成する前に、ビジネスレイヤーとエンジニアリング連携レイヤーに正規化します。
- レビューしやすくするために番号付き階層を使用します。
- フィールド、API、オーナーシップ、シナリオ、計算、ステータス遷移、未解決質問にはテーブルを使用します。
- 複数のシステムが変更される場合は、システム別に要件を分離します。
- 製品が読めるセクションは製品が読めるままにし、低レベルの詳細はAPI/データセクションまたは未解決質問に移動します。
- ユーザーがプロトタイプや既存のPRD構造に基づいて作業するよう指示した場合は、それらに従います。
スコープ順守
常に以下を分離します:
対象範囲内対象範囲外このフェーズではサポートしない将来のイテレーション
将来のフェーズの機能を現在のフェーズの要件に含めないでください。ただし、明示的な除外事項、互換性に関する注意事項、または将来のイテレーションとして記載する場合を除きます。
フローとデータ要件
システム間の作業の場合:
- 作成/クエリ/コールバック/更新/決済/調整フローを、該当する場合は別々に記述します
- 永続化ポイントとステータス変更を特定します
- 設定時のフィールドとランタイムのフィールドを区別します
- スナップショットフィールドと動的に解決されるフィールドを区別します
- フィールド名は慎重に使用します。単数形/複数形はスコープをエンコードする場合があります(例:「portalCode」と「portalCodes」)
ガードレール
- 過去のPRDは、ユーザーが書き換えを依頼しない限り、学習/参考資料として扱います。
- 以前のプロジェクトから無関係なコンテキストを注入しないでください。
- ユーザーが要件を尋ねているときにコードを出力しないでください。
- マーケティング言語になるほど過度に磨き上げないでください。
- 未決定事項を隠さないでください。所有者/依存関係が判明している場合はそれらと共に明確にリストします。
フラグすべきよくある間違い
- 方向性アライメントの準備ができる前に詳細な要件を作成すること。
- アサンプションをラベル付けせずに要件に変換すること。
- 現在のMVPと将来のイテレーションの動作を混在させること。
- 状態、オーナーシップ、例外処理を暗黙のままにして、ページ/ボタンの動作のみを記述すること。
- PRD内でデータベース、キュー、リトライジョブ、サービス設計を過度に規定すること。
- ビジネス目標とスコープ境界を確認せずに、実装リクエストを製品準備完了として扱うこと。
ルーティング
- ビジネスの方向性、プラットフォームの抽象化、または意思決定のフレーミングが準備できていない場合は、
platform-product-guideにルーティングします。 - フロー主体のセクションは、PRDコンテンツに変換する前に、
platform-flow-modelerにルーティングします。 - 現在のフェーズの包含範囲、MVPサイズ、または隠れた複雑性が未解決の場合は、
platform-scope-checkerにルーティングします。 - ドラフト作成後、ユーザーが準備状況、ギャップ、またはスコアを希望する場合は、
platform-prd-reviewerにルーティングします。 - RFCレベルの実装に関する質問は、製品のセマンティクスをPRDに保持しながら、エンジニアリングフォローアップにルーティングします。
品質チェックリスト
最終確定する前に、以下を確認します:
- ドキュメントは、何を構築するかとその理由を説明していますか?
- スコープが明示的ですか?:対象範囲内、対象範囲外、現在サポートしない、将来。
- 要件は、QAまたはエンジニアリングレビューにとって十分テスト可能ですか?
- システム間のオーナーシップと信頼できる情報源が可視化されていますか?
- アサンプションは確定した決定事項から分離されていますか?
- 技術的な考慮事項は、実装を過度に規定せずに表面化されていますか?
- 次のルートまたはレビューステップが明示されていますか?
リファレンス
references/prd-output-contract.md:詳細なテンプレート、成果物固有の契約、または品質チェックリストが必要な場合に読み込みます。