mcpField
P
prd-creator

prd-creator

github.com/pageai-pro開発3335.1k 回インストール17 週間前に更新
リポジトリ

prd-creator について

初級開発者向けに、質問で要件を整理し、前提条件を確認してソフトウェア構想を PRD と実装タスクリストにまとめるスキルです。プロジェクト概要も作成し、機密値にはプレースホルダーを使います。

主な機能

  1. 01構造化された要件確認
  2. 02前提条件とアクセスの確認
  3. 03PRD の作成と更新
  4. 04JSON 実装タスクリストの生成
  5. 05プロジェクト概要の作成

活用シーン

  1. 01初期段階のソフトウェア構想を文書化
  2. 02承認済み PRD を開発タスクに分解
  3. 03仕様作成前にプロジェクト条件を確認

インストール

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

$npx skills add https://github.com/pageai-pro/ralph-loop --skill prd-creator

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

同梱ファイルJSON.mdPRD.md

詳細

PRD 作成アシスタント

2 部構成のプロセスを通じて、ソフトウェアのアイデアを包括的な PRD と実行可能な実装タスクに変換します。

概要

このスキルは、初心者レベルの開発者を支援します。

  1. ユーザーから実装内容の説明を受け取ります
  2. 構造化された質問を通じて、詳細な PRD ドキュメントを作成します
  3. アクセス権、MCP、ドキュメント、環境変数、テストユーザーなど、実装の前提条件を確認します
  4. 開発者向けの実装タスクリストを JSON 形式で生成します
  5. プロジェクトの全体的な説明を作成します。アプリと主な機能を大まかに紹介するエグゼクティブサマリーです。
パート 1:実装内容の説明

ユーザーから不十分な実装内容の説明を受け取ります。 主な目的は、意図を理解し、全体的なアーキテクチャと堅牢な実装方法を検討して、不足している情報を補うことです。

パート 2:PRD の作成

ファイル:PRD.md

実装内容を明確に理解するため、確認の質問をする必要があります。

使用する場面:ユーザーがソフトウェアのアイデアを文書化したい場合、または機能仕様を作成したい場合

機能:

  • 要件を収集するための構造化された質問を行います
  • PRD の最終化前に、プロジェクトの前提条件を確認します
  • プレースホルダー値のみを使って .env.local を作成または更新します
  • 検証用のエグゼクティブサマリーを作成します
  • 競合状況を調査します
  • 以下を含む包括的な PRD.md を生成します:
    • アプリの概要と目的
    • 対象ユーザー
    • 成功指標と KPI
    • 競合分析
    • 主要機能とユーザーフロー
    • 技術スタックの推奨事項
    • 前提条件とアクセス権
    • セキュリティに関する考慮事項
    • 想定事項と依存関係

プロセス:

  1. AskUserQuestion ツールを使って確認の質問をします
  2. 前提条件を確認し、.env.local のプレースホルダーを作成または更新します
  3. ユーザーの承認を得るため、エグゼクティブサマリーを作成します
  4. WebSearch を使って競合を調査します
  5. 完全な PRD を生成します
  6. フィードバックに基づいて繰り返し改善します

詳しい手順については、PRD.md をお読みください。


パート 3:実装タスクの生成

ファイル:JSON.md

完成した PRD を分析し、包括的なタスクリストを JSON 形式で生成する必要があります。

使用する場面:PRD が完成して承認された後、またはユーザーがタスクの分解を求めた場合

機能:

  • 完成した PRD を分析します
  • 前提条件の確認を必須タスクとして TASK-1 に生成します
  • PRD のすべての機能と要件を網羅した実装タスクの完全なリストを JSON 形式で生成します
  • タスクを小さく、取り組みやすい単位に保ちます
  • タスクを種類別(機能、UI/UX、API エンドポイント、セキュリティなど)に分類します
  • 各タスクの検証(「合格」)手順を定義します
  • 開発者がそのまま使えるチェックリストを作成します

重要:

  • 各タスクは、最大 10 分で完了できる程度にシンプルにしてください。
  • タスクが複雑すぎる場合は、より小さなタスクに分割してください。

詳しい手順については、JSON.md をお読みください。

パート 4:全体的な説明

完成した PRD を読み、PROJECT_ROOT/.agent/prd/SUMMARY.md にプロジェクトの全体的な説明を作成する必要があります。

説明は簡潔にまとめ、以下を含めてください:

  • プロジェクトの全体的な説明
  • アプリの主な機能
  • 主要なユーザーフロー
  • 主要な要件の簡単なリスト

クイックスタート

ユーザーがPRDの作成を希望する場合:

  1. PRD.md を読みます
  2. PRD作成ワークフローに従います
  3. 前提条件を確認し、プレースホルダー値のみを使って .env.local を作成または更新します
  4. 必要に応じて、全体の説明 SUMMARY.md を更新します
  5. PRDの作成が完了したら、「実装タスクを生成しますか? パート2をご覧ください。」と尋ねます

ユーザーが既存のPRDに対する実装タスクを希望する場合:

  1. JSON.md を読みます
  2. PRDファイルを読みます
  3. TASK-1 の前提条件確認から始まる、包括的なタスクリストをJSON形式で生成します
  4. tasks.json として保存します

ユーザーが両方を希望する場合:

  1. 前提条件の確認と .env.local のプレースホルダーを含め、まずPRDを作成します PRD.md
  2. ユーザーのPRD承認を得ます
  3. 必要に応じて、全体の説明 SUMMARY.md を更新します
  4. 実装タスクの生成に進みます JSON.md

ユーザーがPRDの更新を希望する場合:

  1. PRD.md を読みます
  2. PRDを更新します
  3. PRD.md として保存します
  4. 必要に応じて、全体の説明 SUMMARY.md を更新します
  5. 実装タスクを生成するかユーザーに尋ねます

ユーザーが実装タスクの更新を希望する場合:

  1. JSON.md を読みます
  2. 実装タスクを更新します
  3. tasks.json として保存します
  4. PRDも再度更新するかユーザーに尋ねます

ユーザーがPRDと実装タスクの両方の更新を希望する場合:

  1. まずPRDを更新します PRD.md
  2. 必要に応じて、全体の説明 SUMMARY.md を更新します
  3. 実装タスクを更新します JSON.md
  4. PRD.md と tasks.json として保存します

完了後

必須ファイルが揃っていることを確認します:

  • PROJECT_ROOT/.agent/prd/PRD.md
  • PROJECT_ROOT/.agent/prd/SUMMARY.md
  • PROJECT_ROOT/.agent/tasks.json

ファイルが揃っていない場合はユーザーに警告し、作成するかどうか尋ねます。

重要な制約

  • コードは生成せず、ドキュメントとタスク仕様に集中します
  • パート1では、要件を明確にするためにAskUserQuestionを積極的に使用します
  • PRD、タスク、チャット、ログ、.env.local に実際のシークレット値を書き込まないでください。プレースホルダー値を使い、実際の値はユーザーが手動で入力するよう伝えます
  • パート2では、包括的なタスクリストを生成します(一般的なプロジェクトでは50~200件以上)
  • パート2では、機能の作業に入る前の前提条件確認として、必ず TASK-1 を生成します
  • タスクの生成時は常に "passes": false で初期化し、完了済みとしてマークしないでください
  • 利用可能なツールを使用します:AskUserQuestion、WebSearch、Sequential Thinking、Read

コメント