to-prd について
to-prdは、会話の文脈とコードベースの理解からPRDを作成し、プロジェクトの課題トラッカーへ公開するスキルです。ユーザーへの聞き取りをせず、リポジトリの確認やテストの接点選定、文書構成を進めます。
主な機能
- 01既存の文脈からPRDを作成
- 02リポジトリとドメイン用語の確認
- 03高いレベルのテスト接点を選定
- 04構造化されたPRDテンプレート
- 05トリアージラベルを付けて公開
活用シーン
- 01既存の議論を基に機能PRDを作成
- 02実装とテストの判断を記録
- 03エージェント作業用のPRDを準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/to-prdを入力して読み込まれたか確認します。
詳細
このスキルは、現在の会話コンテキストとコードベースに関する理解をもとに、PRD を作成します。ユーザーに質問してはいけません。すでに把握している情報を統合してください。
課題トラッカーとトリアージラベルの語彙は、すでに提供されているはずです。提供されていない場合は、/setup-matt-pocock-skills を実行してください。
プロセス
-
まだ確認していない場合は、リポジトリを調査してコードベースの現状を把握します。PRD 全体でプロジェクトのドメイン用語集の語彙を使用し、対象領域の ADR を遵守してください。
-
機能をテストする接点を検討します。新しい接点より既存の接点を優先します。可能な限り上位の接点を使用してください。新しい接点が必要な場合は、可能な限り上位に提案します。コードベース全体で接点を設ける箇所は、少ないほどよく、理想的には 1 つです。
これらの接点がユーザーの期待に合っているか確認してください。
- 以下のテンプレートを使用して PRD を作成し、プロジェクトの課題トラッカーに公開します。トリアージラベル
ready-for-agentを適用してください。追加のトリアージは不要です。
問題の説明
ユーザーの視点から見た、ユーザーが直面している問題。
解決策
ユーザーの視点から見た、問題の解決策。
ユーザーストーリー
ユーザーストーリーの番号付きリストを多数記載します。各ユーザーストーリーは、次の形式にしてください。
- <アクター>として、<機能>を実現したい。それによって、<メリット>が得られる。
このユーザーストーリーのリストでは、機能のあらゆる側面を網羅し、非常に詳細に記載してください。
実装上の決定事項
決定した実装上の事項を列挙します。以下の内容を含めることができます。
- 作成または変更するモジュール
- 変更するモジュールのインターフェース
- 開発者による技術的な明確化
- アーキテクチャ上の決定
- スキーマの変更
- API コントラクト
- 具体的なインタラクション
具体的なファイルパスやコードスニペットは記載しないでください。すぐに古くなる可能性があります。
例外：プロトタイプで作成したスニペットが、説明文よりも正確に決定事項を表現できる場合（状態機械、リデューサー、スキーマ、型の形状など）は、該当する決定事項に含め、プロトタイプ由来であることを簡潔に記してください。動作するデモではなく、決定事項を明確に示す重要な部分だけを残してください。
テスト上の決定事項
テストに関する決定事項を列挙します。以下の内容を含めてください。
- 優れたテストの説明（実装の詳細ではなく、外部から見える振る舞いだけをテストする）
- テスト対象のモジュール
- テストの先例（コードベース内にある、類似した種類のテストなど）
スコープ外
この PRD の対象外となる内容を説明します。
補足
機能に関するその他の補足事項。