to-prd について
to-prd は、会話の文脈とコードベースの理解から PRD を作成するスキルです。ユーザーへの聞き取りは行わず、テスト seam を確認してから PRD を issue tracker に登録します。
主な機能
- 01会話とリポジトリの文脈から PRD を作成
- 02作成前にリポジトリを調査
- 03テスト seam の提案と確認
- 04指定テンプレートの使用
- 05ready-for-agent ラベル付きで登録
活用シーン
- 01既存のプロジェクト文脈から PRD を作成
- 02機能テストの高レベルな seam の選定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/to-prdを入力して読み込まれたか確認します。
詳細
このスキルでは、現在の会話コンテキストとコードベースの理解を使って PRD を作成します。ユーザーへの聞き取りは行わないでください。すでに把握している内容のみをまとめます。
Issue tracker と triage label の語彙は、すでに提供されているはずです。提供されていない場合は、/setup-matt-pocock-skills を実行してください。
Process
-
まだリポジトリを調査していない場合は、まず調査してコードベースの現在の状態を理解します。PRD では常にプロジェクトのドメイン用語集の語彙を使用し、関連する ADR に従ってください。
-
この機能をどの seam でテストするか草案を作成します。新しい seam を追加するよりも、既存の seam を優先します。可能な限り高いレイヤーの seam を使用してください。新しい seam が本当に必要な場合は、できる限り高いレイヤーで提案してください。
これらの seam が期待に沿っているか、ユーザーに確認します。
- 以下のテンプレートを使用して PRD を作成し、プロジェクトの issue tracker に投稿します。
ready-for-agentの triage label を適用してください。追加の triage は不要です。
Problem Statement
ユーザーの視点から、ユーザーが直面している問題を説明します。
Solution
ユーザーの視点から、問題の解決策を説明します。
User Stories
長い番号付きの user stories リストを作成します。各 user story は次の形式にします。
- As an , I want a , so that
この user stories リストでは、機能のあらゆる側面を網羅してください。
Implementation Decisions
すでに決定している implementation decisions のリストです。以下を含めることができます。
- build／変更する modules
- 変更する module interfaces
- developer からの技術的な明確化
- Architectural decisions
- Schema changes
- API contracts
- 具体的な interactions
具体的な file paths や code snippets は含めないでください。すぐに古くなる可能性があります。
例外：prototype で生成した snippet のほうが prose よりも決定事項（state machine、reducer、schema、type shape など）を正確に表現できる場合は、関連する decision にインラインで含め、prototype に由来することを簡潔に説明できます。決定事項が凝縮された部分だけを残し、完全な working demo は含めないでください。
Testing Decisions
すでに決定している testing decisions のリストです。以下を含めます。
- 優れたテストとは何かの説明（implementation details ではなく external behavior のみをテストします）
- テスト対象の modules
- テストの prior art（コードベース内にある、類似した種類の tests）
Out of Scope
この PRD の範囲外となる事項を説明します。
Further Notes
この機能に関するその他の notes です。