mcpField
G
generate-prd

generate-prd

github.com/cfircooドキュメント1737 回インストール31 週間前に更新
リポジトリ

generate-prd について

機能の議論を実装向けの PRD にまとめる、プロダクトチームや開発者向けのスキルです。構造化された確認質問を行い、範囲を定めた文書を保存します。実装は行いません。

主な機能

  1. 013~5件の構造化された確認質問
  2. 029セクション構成の PRD 作成
  3. 03テスト可能な受け入れ基準の定義
  4. 04機能要件への番号付け
  5. 05tasks/prd-[feature-name].md への保存

活用シーン

  1. 01開発前の機能案の明確化
  2. 02目標、範囲、対象外事項の記録
  3. 03開発者やエージェント向け仕様の準備

インストール

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

$npx skills add https://github.com/cfircoo/claude-code-toolkit --skill generate-prd

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

詳細

新機能に関する詳細で実行可能なプロダクト要件定義書(PRD)を作成します。ユーザーが明確化のための質問に回答できるよう支援し、その後、開発者や AI エージェントが実装に利用できる仕様書を作成します。

重要:このスキルでは PRD のみを作成し、実装には着手しません。

<quick_start>

  1. 選択肢をアルファベット(A、B、C、D)で示した明確化のための質問を 3~5 個行います
  2. 回答に基づいて構成済みの PRD を作成します
  3. tasks/prd-[feature-name].md に保存します </quick_start>
AskUserQuestion ツールを使って、必須の質問を 3~5 個行います。次の内容を取り上げてください。
  • 問題/目標:どのような問題を解決しますか?誰にメリットがありますか?
  • 主要機能:必須の機能は何ですか?
  • 範囲/境界:明確に対象外とするものは何ですか?
  • 成功基準:何をもって成功と判断しますか?

各質問には、具体的な選択肢を 3~4 個(A、B、C、D 形式)と、自由入力用の「その他」を含めてください。

次のセクションで PRD を作成します。
  1. はじめに/概要 – 機能の簡潔な説明と問題の説明
  2. 目標 – 具体的で測定可能な目標
  3. ユーザーストーリー – タイトル、説明、検証可能な受け入れ条件を含めます
  4. 機能要件 – FR-1、FR-2 など、明示的に番号を付けます
  5. 非目標 – 範囲の境界を明確にします
  6. 設計上の考慮事項 – UI/UX 要件(該当する場合)
  7. 技術上の考慮事項 – 制約と依存関係(該当する場合)
  8. 成功指標 – 測定可能な成果
  9. 未解決の質問 – 残っている明確化事項
PRD を次の場所に保存します:`tasks/prd-[feature-name].md`

機能名にはケバブケースを使用してください(例:prd-user-authentication.md)。

専門用語を避けるか、説明を加えてください。具体例を示してください。ジュニア開発者が追加の背景情報なしに、すべての要件を理解できるようにします。 受け入れ条件はテスト可能で具体的である必要があります。

良い例:「ログインに成功すると、ログインボタンが /dashboard に移動する」 悪い例:「ログインが正しく動作する」

UI に関するユーザーストーリーには、必ず次の受け入れ条件を含めてください。 `"Verify in browser using dev-browser skill"` 各ユーザーストーリーは、1 回のセッションで実装できる規模にしてください。大きすぎる場合は、より小さなストーリーに分割してください。

<prd_template>

# PRD: {{Feature Name}}

## 1. Introduction

{{Brief description of the feature and the problem it solves}}

## 2. Goals

- {{Goal 1: Specific, measurable objective}}
- {{Goal 2: Specific, measurable objective}}

## 3. User Stories

### US-1: {{Story Title}}
**As a** {{user type}}, **I want** {{feature}} **so that** {{benefit}}.

**Acceptance Criteria:**
- {{Specific, testable criterion}}
- {{Specific, testable criterion}}
- Verify in browser using dev-browser skill (for UI stories)

### US-2: {{Story Title}}
...

## 4. Functional Requirements

- **FR-1**: {{Explicit requirement}}
- **FR-2**: {{Explicit requirement}}
- **FR-3**: {{Explicit requirement}}

## 5. Non-Goals

- {{What this feature explicitly does NOT do}}
- {{Scope boundary}}

## 6. Design Considerations

{{UI/UX requirements, wireframe references, design patterns}}

## 7. Technical Considerations

{{Constraints, dependencies, integration points, performance requirements}}

## 8. Success Metrics

- {{Measurable outcome 1}}
- {{Measurable outcome 2}}

## 9. Open Questions

- [ ] {{Unresolved question needing clarification}}

</prd_template>

**良い例:** - 「検索結果が 2 秒以内に表示される」 - 「形式が正しくない入力に対して、『Invalid email format』というエラーメッセージが表示される」 - 「『Save』をクリックするとボタンが無効になり、処理が完了するまでスピナーが表示される」

悪い例:

  • 「検索が速い」
  • 「適切なエラーメッセージが表示される」
  • 「保存時の UX が良い」
- **FR-1**:システムは RFC 5322 パターンを使ってメールアドレスの形式を検証します - **FR-2**:パスワードは 8 文字以上で、数字を 1 つ以上含む必要があります - **FR-3**:セッションは 30 分間操作がないと期限切れになります

<success_criteria> 次の条件を満たすと PRD は完成です。

  • 明確化のための質問を 3~5 個行い、回答を得ている
  • 9 つすべての PRD セクションに具体的な内容が記載されている
  • ユーザーストーリーに検証可能な受け入れ条件がある
  • UI に関するストーリーにブラウザーでの検証条件が含まれている
  • 機能要件に番号が付いている(FR-1、FR-2 など)
  • 非目標によって範囲の境界が明確に定義されている
  • ドキュメントが tasks/prd-[feature-name].md に保存されている
  • 実装に着手していない(PRD のみ) </success_criteria>

コメント