to-prd について
to-prdは、会話とコードベースの情報からプロダクト要件書を作成するスキルです。機能についてユーザーに質問せず、リポジトリの確認、テスト境界の検討、Issue trackerへの公開まで扱います。
主な機能
- 01リポジトリの情報とADRの確認
- 02高いレベルでのテスト境界の特定
- 03テンプレートに沿ったPRD作成
- 04Issue trackerへの公開
- 05ready-for-agentラベルの付与
活用シーン
- 01進行中の会話から機能PRDを作成
- 02実装前にテスト境界を記録
- 03Agent向けPRDを公開
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ leandrocfe/ skills --skill to-prdインストール後、Claude Code で/to-prdを入力して読み込まれたか確認します。
詳細
このスキルは、会話の現在のコンテキストとコードベースに関する理解をまとめ、PRD を作成します。ユーザーへのインタビューは行わず、すでに把握している内容だけを要約してください。
Issue Tracker とトリアージラベルの用語集は、すでに提供されているはずです。提供されていない場合は、/setup-leandrocfe-skills を実行してください。
プロセス
-
まだ確認していない場合は、リポジトリを調査してコードベースの現在の状態を把握してください。PRD 全体を通して、プロジェクトのドメイン用語集の語彙を使用し、変更対象の領域に関する ADR に従ってください。
-
この機能をテストする接点を整理してください。新しい接点よりも既存の接点を優先してください。可能な限り最上位の接点を使用してください。新しい接点が必要な場合は、可能な限り最上位のものを提案してください。コードベース全体で接点はできるだけ少なくしてください。理想は 1 つです。
これらの接点がユーザーの期待に合っているか確認してください。
- 以下のテンプレートを使用して PRD を作成し、プロジェクトの Issue Tracker に公開してください。トリアージラベル
ready-for-agentを適用してください。追加のトリアージは不要です。
問題の説明
ユーザーの視点から見た、ユーザーが直面している問題。
解決策
ユーザーの視点から見た、問題の解決策。
ユーザーストーリー
長く、番号付きのユーザーストーリーのリスト。各ユーザーストーリーは次の形式にしてください。
- <利用者>として、私は<メリット>を得るために、<機能>を使いたい
このユーザーストーリーのリストは非常に網羅的で、機能のあらゆる側面を含めてください。
実装上の決定事項
決定した実装上の事項を列挙してください。以下を含めることができます。
- 作成または変更するモジュール
- 変更するモジュールのインターフェース
- 開発者からの技術的な補足
- アーキテクチャ上の決定
- スキーマの変更
- API コントラクト
- 具体的なインタラクション
具体的なファイルパスやコードスニペットは含めないでください。これらはすぐに古くなる可能性があります。
例外:プロトタイプで作成したスニペットが、文章よりも正確に決定事項を表現している場合(状態機械、リデューサー、スキーマ、型の形状など)は、該当する決定事項にインラインで含め、プロトタイプからのものであることを簡潔に明記してください。動作するデモではなく、決定事項が明確になる部分だけを残してください。
テスト上の決定事項
決定したテスト上の事項を列挙してください。以下を含めてください。
- 優れたテストの説明(実装の詳細ではなく、外部から見える動作だけをテストする)
- テスト対象のモジュール
- テストの先行事例(コードベース内にある類似のテストなど)
対象範囲外
この PRD の対象範囲外となる事項の説明。
補足事項
この機能に関するその他の補足事項。