Communitygithub.com

Universal PRD Writer

双方向の2ステップワークフローを通じて、包括的なプロダクト要件文書(PRD-Project)をビジュアルなMermaid図とともに生成します。ユーザーがPRDの作成、ソフトウェア/ウェブ/モバイル/AI/ゲームプロジェクトの計画、仕様書の作成、またはシステムアーキテクチャの設計を依頼した際に使用します。

Universal PRD Writer とは?

このスキルは、あらゆるプロジェクトアイデアを完全で開発者対応のプロダクトおよび技術要件文書(PRD.md)に変換します。2ステップのワークフローを採用しており、最初のステップではユーザーのプロンプトを分析し、プロジェクトの種類(3D/モーションWebサイト、SaaS/Webアプリ、モバイルアプリ、AIエージェント/ボット、ゲーム、CLI/プラグイン、エンタープライズシステムなど)に応じて動的に関連質問を4~5個生成します。2番目のステップでは、収集した情報に基づいて、Overview、Requirements、Core Features、User Flow、Architecture、Database Schema、Tech Stackの7つのセクションから構成されるPRD-Projectを生成します。各セクションには、Mermaid図(フローチャート、シーケンス図、ER図)が適切に埋め込まれ、開発者やAIコーディングエージェントが直接実装できる具体的で実行可能な仕様を提供します。特に、バリッドなMermaid記法(ノードラベルの引用符囲みなど)を厳守し、図がエラーなく描画されるように設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chandrapratamalab/phantom-skill/tree/HEAD/skills/prd-writer

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Universal PRD Writer は何をしますか?

あらゆるプロジェクトアイデアを、完全な開発者対応のプロダクトおよび技術要件文書(PRD.md)に変換します。

ワークフロー

ステップ 1: プロンプトの分析と動的な明確化質問

最初のターンで完全なPRDを生成しないでください。 ただし、ユーザーが明示的に「buat langsung」/「skip questions」と言った場合、または既に完全な詳細を提供している場合は除きます。

  1. プロジェクトの性質を検出: ユーザーのプロンプトから何を構築しているかを特定します(例: 3D/モーションWebサイト、SaaS/Webアプリ、モバイルアプリ、AIエージェント/ボット、ゲーム、CLI/プラグイン、エンタープライズシステム)。
  2. 4~5のハイパー関連質問: その特定のプロジェクトドメインに厳密に合わせた質問を形成します:
    • コアゴール/ターゲットユーザーと期待される最終アクションについて質問します。
    • ドメイン固有のメカニクスについて質問します(例: モーションページの3D/スクロールインタラクション、SaaSのユーザーロールと支払いフロー、ボットのトリガー/APIフロー、ゲームのゲームループ)。
    • MVPスコープの境界と技術/ライブラリの好みまたはデバイス制約について質問します。
  3. クイック例を提供: 各質問の後に短い選択肢を括弧内に含め、ユーザーが迅速に回答できるようにします。また、次のように注意を促します: 「すでに頭の中にあるポイントに答えるか、または「buat langsung」と入力してください。そうすれば、最良のオプションを自動的に選択します。」

ステップ 2: 7セクションのPRD-Projectを生成

ユーザーが回答したら(またはすぐに進めるように依頼したら)、出力をPRD.mdに保存し(コードワークスペースの場合)、以下の正確な7セクション構造に従って文書を提示します。技術的内容をプロジェクトタイプに動的に適応させます:

# PRD-Project: [プロジェクト名]
## 要件文書

### 1. 概要
- **プロダクト概要:** コンセプト、解決する中核的な問題、独自の価値提案。
- **ターゲットオーディエンスとペルソナ:** ユーザーロール、目標、ペインポイント。
- **目標と成功指標:** プロジェクトに適した測定可能なKPI(例: コンバージョン率、FPS/ロード速度、リテンション、タスク精度)。

### 2. 要件
- **機能要件:** ロール、モジュール、または画面セクションごとに論理的にグループ化されたコア機能。
- **非機能要件:** パフォーマンスベンチマーク、レスポンシブ性、セキュリティ、互換性、リソース制限。
- **スコープ外(フェーズ1):** 初期バージョンから意図的に除外された機能。

### 3. コア機能
各機能/モジュールについて、以下を指定します:
- **優先度:** P0(必須)、P1(優先)、P2(あると嬉しい)。
- **ユーザーストーリー:** [ロール]として、[アクション]を実行したい。その理由は[ベネフィット]のため。
- **受入基準:** 具体的でテスト可能な合格/不合格条件。
- **エッジケースとフォールバック:** エラー処理、空の状態、弱いデバイス/未サポートブラウザ、または失敗したリクエストの処理。

### 4. ユーザーフロー
- **ステップバイステップのジャーニー:** 開始から終了までの時系列のユーザーまたはシステムインタラクションパス。
- **ビジュアルフローチャート:** クリーンな`mermaid`図(`flowchart TD`または`sequenceDiagram`)をレンダリングします。

### 5. アーキテクチャ
- **システムとフォルダ構造:** 高レベルのコンポーネント相互作用と推奨ディレクトリレイアウト。
- **アーキテクチャ図:** UI、ロジック、API、レンダーループ、外部サービスがどのように接続されるかを示す`mermaid`図をレンダリングします。
- **コアモジュール/エンドポイント:** 主要なルート、コントローラー、またはイベントハンドラーの表。

### 6. データベーススキーマ(プロジェクトタイプに適応)
- **バックエンド/永続アプリの場合:** Mermaid `erDiagram`とテーブルスキーマ(フィールド、型、PK/FK制約、リレーションシップ)を提供します。
- **フロントエンドのみ/静的/3D/CLI/ツールの場合:** SQLテーブルの代わりに、ローカル状態スキーマ、設定JSON構造、アセットマニフェスト、またはフォーム/イベントペイロードスキーマを定義します。

### 7. テクノロジースタック
ユーザーの制約に合わせて、最適なツールを簡単な正当性とともに推奨します(フロントエンド/UI、ロジック/バックエンド、データ/アセット、デプロイメント)。

図と品質ルール

  • 有効なMermaidのみ: スペース、括弧、または記号を含むノードラベルは常に二重引用符で囲みます(例: A["Hero Section (3D View)"] --> B["Scroll Trigger"])。これにより、図が構文エラーなくクリーンにレンダリングされます。
  • 無駄の排除: 仕様は具体的で、実行可能で、開発者やAIコーディングエージェントが直接実装できる状態に保ちます。

関連スキル