mcpField
P
prd-interview

prd-interview

github.com/mwguerra開発3644 回インストール26 週間前に更新
リポジトリ

prd-interview について

prd-interviewは、構造化されたインタビューを通じて初期のアイデアを実行可能なPRDにまとめるスキルです。製品・機能・バグ修正に応じて質問を調整し、Mermaid図や階層化されたタスクも作成できます。

主な機能

  1. 018つの要件カテゴリでインタビュー
  2. 02状況に応じて質問を省略
  3. 03各テーマを要約してPRDを作成
  4. 04Mermaid図の生成
  5. 05taskmanagerへのタスク分解連携

活用シーン

  1. 01初期の製品案をPRDにまとめる
  2. 02新機能の実装要件を整理する
  3. 03バグの背景と回帰テスト方針を記録する

インストール

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

$npx skills add https://github.com/mwguerra/claude-code-plugins --skill prd-interview

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

同梱ファイルreferences/question-bank.mdtemplates/prd-template.md

詳細

PRD インタビュースキル

8つのカテゴリにわたる体系的なヒアリングを通じて、漠然としたアイデアを実行可能なプロダクト要件定義書にまとめるための、包括的なインタビューをガイドします。

インタビューの基本プロセス

インタビューの流れ
  1. 最初のプロンプト:ユーザー自身の言葉で基本的なアイデアを把握します
  2. カテゴリ別のヒアリング:AskUserQuestion を使って、関連するカテゴリを順に確認します
  3. 状況に応じた分岐:コンテキストに応じて、関連性のない質問を省略します
  4. 段階的な要約:次のカテゴリに進む前に、各カテゴリの内容を要約します
  5. ドキュメントの生成:Mermaid 図を含む最終的な PRD を作成します
  6. タスクとの連携:taskmanager を使った階層的なタスクの生成を提案します
インタビューのカテゴリ

次の8つのカテゴリにわたってインタビューを行います(PRD の種類に応じて調整してください)。

カテゴリ注目する領域使用する場面
問題と背景課題、現状、今取り組む理由常に
ユーザーと顧客ペルソナ、セグメント、ユーザージャーニー常に
ソリューションと機能機能リスト、MVP の範囲、優先順位常に
技術的な実装アーキテクチャ、スタック、統合常に
ビジネスと価値ROI、価格設定、収益モデルプロダクト、主要機能
UX とデザインフロー、ワイヤーフレーム、アクセシビリティUI に関わる作業
リスクと懸念事項依存関係、前提、ブロッカー常に
テストと品質テスト戦略、受け入れ基準常に
質問のガイドライン

AskUserQuestion を使う場合:

  • 1ラウンドあたりの質問は最大2~4問にします
  • 可能な場合は具体的な選択肢を提示します
  • 相互排他的でない選択肢には multiSelect を有効にします
  • 「その他」は自動的に含めます(ツールが処理します)
  • 短いヘッダーを使います(最大12文字)
状況に応じた分岐ルール

状況に応じてカテゴリを省略します。

  • 社内ツール:ビジネスと価値の価格設定/収益に関する質問を省略します
  • バックエンドのみ:UX とデザインのカテゴリを最小限にします
  • バグ修正:問題と背景、技術、テストに重点を置きます
  • 機能開発:すべてのカテゴリでヒアリングしますが、ビジネスと価値は簡略化します

セッション状態の管理

状態ファイルの場所

インタビューの進行状況を次の場所に保存します:.taskmanager/prd-state.json

状態の構造
{
  "sessionId": "uuid",
  "prdType": "product|feature|bugfix",
  "slug": "feature-name",
  "startedAt": "ISO timestamp",
  "lastUpdatedAt": "ISO timestamp",
  "currentCategory": "category-name",
  "completedCategories": ["category1", "category2"],
  "answers": {
    "category-name": {
      "question-key": "answer-value"
    }
  },
  "initialPrompt": "User's original description"
}
セッションの再開

/prd-builder:prd などが呼び出された場合:

  1. .taskmanager/prd-state.json に既存の状態があるか確認します
  2. 見つかった場合、ユーザーに「'{slug}' の前回のセッションを再開しますか?それとも新しいセッションを開始しますか?」と尋ねます
  3. 再開する場合は、currentCategory から続行します
  4. 新しく開始する場合は、古い状態をアーカイブして新しいセッションを開始します

PRD ドキュメントの構成

出力先

PRD を次の場所に保存します:docs/prd/prd-{slug}.md

ドキュメントテンプレート

templates/prd-template.md のテンプレートに従って PRD を生成します。主なセクションは次のとおりです。

  1. ヘッダー:タイトル、バージョン、日付、ステータス、作成者
  2. エグゼクティブサマリー:1段落での概要
  3. 問題の説明:どのような問題か、誰が抱えているか、現在の解決策
  4. ユーザーとペルソナ:特性を含む対象ユーザー
  5. ソリューションの概要:高レベルのアプローチ
  6. 機能と要件:優先順位を含む詳細な機能の内訳
  7. 技術アーキテクチャ:スタック、統合、Mermaid 図
  8. ユーザーエクスペリエンス:フロー、ワイヤーフレームへの参照
  9. ビジネスケース:価値提案、価格設定(該当する場合)
  10. リスクと軽減策:既知のリスクと軽減戦略
  11. テスト戦略:受け入れ基準、テストアプローチ
  12. タイムラインとマイルストーン:フェーズごとの内訳(該当する場合)
  13. 未解決の質問:今後対応する未解決事項
Mermaid 図

適切な箇所に次の図を含めます。

アーキテクチャ図:

graph TB
    subgraph Frontend
        UI[User Interface]
    end
    subgraph Backend
        API[API Layer]
        DB[(Database)]
    end
    UI --> API --> DB

ユーザーフロー図:

flowchart LR
    A[Start] --> B{Decision}
    B -->|Yes| C[Action]
    B -->|No| D[Alternative]

TaskManager との連携

タスク生成プロセス

PRD の完成後:

  1. PRD からすべての機能を抽出します
  2. 階層的なタスク構造を作成します:
    • 主要機能ごとに親タスクを作成
    • 実装手順ごとに子タスクを作成
  3. PRD ファイルのパスを指定して /taskmanager:plan を使います
タスク階層の例
Feature: User Authentication
├── Setup authentication infrastructure
├── Implement login endpoint
├── Implement registration endpoint
├── Add password reset flow
├── Create authentication middleware
└── Write authentication tests
自動実行

タスクを生成した後、「タスクを作成しました。自律実行を開始しますか?」と尋ねます。 はいの場合は、/taskmanager:run を呼び出して実装を開始します。

PRD の種類

フルプロダクト PRD(/prd-builder:prd)

8 つのカテゴリすべてを網羅する詳細なインタビューです。

  • 10〜15 回の質問ラウンド
  • 包括的なドキュメント
  • 完全な Mermaid 図
  • 完全なタスクの内訳
機能 PRD(/prd-builder:feature)

実装に焦点を当てた、簡潔なインタビューです。

  • 5〜8 回の質問ラウンド
  • ビジネスと価値に関する項目は省略または最小限にします(収益化する機能を除く)
  • 技術、UX、テストに焦点を当てます
  • 製品のコンテキストがすでに存在することを前提とします
バグ修正 PRD(/prd-builder:bugfix)

問題に焦点を当てたドキュメントです。

  • 3〜5 回の質問ラウンド
  • 問題とコンテキストに重点を置きます
  • 技術的な根本原因を分析します
  • リグレッションテスト戦略を策定します
  • ビジネスに関する項目は省略し、UX は最小限にします
PRD の改善(/prd-builder:refine)

既存の PRD を強化します。

  1. 既存の PRD を読み、分析します
  2. 不十分または不足しているセクションを特定します
  3. 不足部分についてのみ、対象を絞った質問をします
  4. 新しい回答を既存のドキュメントに統合します
  5. 十分な内容の元のコンテンツは保持します

追加リソース

参照ファイル

各カテゴリの詳細な質問集:

  • references/question-bank.md - カテゴリ別に整理された質問ライブラリ
テンプレートファイル

PRD 出力テンプレート:

  • templates/prd-template.md - PRD ドキュメントの全体構成

コメント