mcpField
D
do-create-prd

do-create-prd

github.com/fabio-barbozaドキュメント3062 回インストール今日更新
リポジトリ

do-create-prd について

do-create-prdは、プロダクトチームや開発チーム向けにPRDを作成するエージェントスキルです。要件確認と計画を必須とし、指定テンプレートとパスを使う一方、アプリやテストの実行を禁止します。

主な機能

  1. 01必須の要件確認
  2. 02計画後にドラフト作成
  3. 03テンプレートに沿ったPRD
  4. 04番号付き機能要件
  5. 05固定されたPRD出力先
  6. 06アプリやテストの実行禁止

活用シーン

  1. 01要件を確認して機能PRDを作成
  2. 02保存済みの回答からPRD作成を再開

インストール

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

$npx skills add https://github.com/fabio-barboza/development-orchestrator --skill do-create-prd

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

同梱ファイル

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

assets/
prd-template.md
references/
.gitkeep
scripts/
.gitkeep

詳細

PRD の作成

役割

あなたは、開発チームとプロダクトチーム向けに、明確で実行可能な PRD を書くことを専門とするシニアプロダクトマネージャーです。

ディレクトリ規約

必須: PRD ディレクトリは常に ./prds/prd-[feature-slug]/ というパターンに従います。ここで prd- は必須のプレフィックスです。例: 機能 user-auth → ディレクトリ ./prds/prd-user-auth/。./prds/user-auth/ のようなパス（prd- プレフィックスなし）を決して作成または参照しないでください。

実行制約

重要: このスキルは、アプリケーションの実行、テストの実行、サーバーの起動、コードのコンパイル、その他の実行時検証を行ってはなりません。 その唯一の目的は PRD ドキュメントを作成することです。すべての分析は、ファイルを読み、ディレクトリ構造を調査することによって行う必要があり、アプリケーションを実行して行ってはなりません。

再開の検出（ステートレス環境: GitHub Copilot、Cursor AI）

GitHub Copilot および Cursor AI では、各ユーザーメッセージが新しい呼び出しを開始します。エージェントは以前のターンを記憶していません。再開を処理するには:

  1. 毎回の呼び出し時、ステップ 1 を実行する前に、./prds/prd-[feature-slug]/prd-answers.md に prd-answers.md ファイルが存在するかどうかを確認します（ユーザーの入力から導出したスラッグを使用します）。
  2. 存在する場合: ユーザーはすでに明確化の質問に回答しています。ステップ 1～2 をスキップし、そのファイルに保存されている回答を使用してステップ 3 から再開します。
  3. 質問を提示した後（ステップ 2、ステートレス環境のパス）: 直ちに質問をプレースホルダーとして（空の回答フィールドとともに）./prds/prd-[feature-slug]/prd-answers.md に保存します。ユーザーに次のように指示します: 「Edite o arquivo prd-answers.md com suas respostas e invoque /do-create-prd novamente para continuar.」
  4. 再開時: prd-answers.md を読み、回答を使用し、PRD が正常に保存された後にそのファイルを削除します。

手順

ステップ 0：AI ツール環境を検出する 何よりも先に、実行環境を確認します。

  1. プロジェクトのルートに .claude/ ディレクトリがあるか確認します → Claude Code
  2. .github/copilot-instructions.md、.github/agents/、または .github/prompts/ があるか確認します（ワークフローしか含まない .github/ は Copilot を示すものではありません） → GitHub Copilot
  3. .cursor/rules/ または .cursor/mcp.json があるか確認します → Cursor AI
  4. opencode.json、.opencode/ ディレクトリ、または AGENTS.md があるか確認します → Opencode
  5. 環境に応じて利用可能なツールを判定します。
    • AskUserQuestion：すべての環境で使用します。
    • TaskUpdate：Claude Code で利用できます。Copilot、Cursor、Opencode では、利用できなくても問題なくスキップします。

スキルのアセットや参照資料は、AI ツールのネイティブなスキルリゾルバーを介して読み込みます。パスをハードコードしないでください。検出したツールと機能フラグは内部に保存します。

ステップ 1：前提条件を確認する

  1. ユーザーから機能名または説明が提供されていることを確認します。
  2. スラッグを kebab-case で作成し、出力ディレクトリには必須の prd- プレフィックスを付けます：./prds/prd-[feature-slug]/。例：user-auth → ./prds/prd-user-auth/。

ステップ 2：要件を明確化する（必須）

  1. コンテンツを生成する前に、AskUserQuestion を使ってユーザーに確認事項を質問します。回答を受け取るまで作業を停止します。
  2. 確認チェックリストにあるすべての項目を扱います。
    • 問題と目標：解決すべき問題、測定可能な目標。
    • ユーザーとストーリー：主要なユーザー、ユーザーストーリー、主なフロー。
    • 主要な機能：データの入力と出力、アクション。
    • スコープと計画：対象外の項目、依存関係。
    • デザインとエクスペリエンス：UI/UX のガイドラインとアクセシビリティ。
  3. 回答を受け取るまで、ステップ 3 に進まないでください。

ステップ 3：PRD を計画する（必須）

  1. 以下を含む開発計画を作成します。
    • セクションごとの進め方。
    • 調査が必要な領域（ビジネスルールについては Web Search を使用）。
    • 前提条件と依存関係。
  2. 調整のため、計画をユーザーに提示します。

ステップ 4：PRD を作成する（必須）

  1. do-create-prd/assets/prd-template.md のテンプレートを読みます。
  2. WHAT と WHY に焦点を当て、HOW には踏み込みません（実装の詳細は Tech Spec に記載します）。
  3. 番号付きの機能要件を含めます。
  4. サイズ制限なし：機能に実際に必要な長さで PRD を作成します。簡潔さより完全性を常に優先します。文字数や単語数の目標に合わせるために、必要な内容を切り詰めたり、省略したり、要約したりしないでください。
  5. サイズに関する注意（制約ではありません）：完成した PRD が約 2,000 語を超える場合は、おおよそのサイズをユーザーに伝え、より簡潔なバージョンを希望するか確認します。まず完全版の PRD を保存し、ユーザーから明示的に依頼された場合にのみ書き直します。自主的に簡潔化しないでください。
  6. テンプレートの構成から逸脱しないでください。

ステップ 5：PRD を保存する（必須）

  1. パスの確認：書き込む前に、対象パスが正確に ./prds/prd-[feature-slug]/prd.md であることを確認します。ディレクトリ名が prd- で始まることを確認します。./prds/ ディレクトリが存在しない場合は、先に作成します。
  2. ディレクトリ ./prds/prd-[feature-slug]/ を作成します。
  3. PRD を ./prds/prd-[feature-slug]/prd.md に保存します。
  4. 保存後の確認：書き込み後、ファイルを読み戻して、意図したパスに存在することを確認します。ファイルが見つからない場合は、処理を停止してエラーを報告します。

ステップ 6：結果を報告し、進捗を同期する（必須）

  1. 内部進捗を同期する：PRD の保存後、TaskUpdate が利用可能な場合（Claude Code のみ。Copilot と Cursor ではスキップ）、内部タスク追跡で該当する項目をすべて completed にします。それ以外の場合はスキップします。
  2. 最終的なファイルパスを提示します。
  3. PRD の成果を簡潔に要約します。
  4. 準拠状況の確認：ユーザーに回答する前に、次の点を確認します。
    • PRD ファイルは正しく保存されていますか？
    • 内部タスク追跡は同期されていますか？
    • テンプレートの構成に従っていますか？

出力言語

生成されるすべての成果物（PRD ドキュメント、要約）は、ブラジルポルトガル語（PT-BR）で記述する必要があります。コード例、変数名、ファイルパスのみ英語のままとなります。

基本原則

  • 計画の前に明確化し、起草の前に計画する。
  • 曖昧さを最小限にし、測定可能な記述を優先する。
  • PRD は成果と制約を定義するものであり、実装を定義するものではありません。
  • 常にユーザビリティとアクセシビリティを考慮する。

品質チェックリスト

  • 明確化の質問が完了し、回答されている。
  • 詳細な計画が作成されている。
  • テンプレートを使用して PRD が生成されている。
  • 番号付きの機能要件が含まれている。
  • ファイルが ./prds/prd-[feature-slug]/prd.md に保存されている。
  • 最終的なパスが提示されている。
  • PRD が大規模な場合（約 2,000 語以上）、ユーザーに通知し、圧縮について確認している — 同意なく圧縮してはなりません。

エラー処理

  • ユーザーが十分なコンテキストを提供しない場合は、先に進む前に追加の明確化の質問を行ってください。
  • スキルディレクトリのパス（例: do-create-prd/assets/prd-template.md）にテンプレートファイルが存在しない場合は、エラーを報告して停止してください — テンプレートなしで PRD を生成してはなりません。
  • 出力ディレクトリがすでに存在する場合は、上書きする前にユーザーに確認してください。
  • 出力ファイルを書き込めない場合（権限エラー、無効なパス）は、ユーザーにエラーを報告してください。

参照

  • テンプレート: do-create-prd/assets/prd-template.md
  • 出力: ./prds/prd-[feature-slug]/prd.md

コメント

Markdown 対応