to-prd について
to-prd は、会話の文脈とコードベースの理解を PRD にまとめ、プロジェクトの課題トラッカーへ公開する開発スキルです。リポジトリ調査、テスト箇所、ユーザーストーリー、実装・テスト方針を扱う手順を定めています。
主な機能
- 01文脈を統合して PRD を作成
- 02リポジトリを調査しドメイン用語を採用
- 03テスト箇所を特定し承認済みとして扱う
- 04詳細な PRD テンプレートを使用
- 05トリアージラベルを付けてトラッカーに公開
活用シーン
- 01既存の議論から機能提案を文書化
- 02リポジトリの慣習に沿った PRD 作成
- 03Agent 向けの課題をトラッカーに登録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ utarn/ engineer-skills --skill to-prdインストール後、Claude Code で/to-prdを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
このスキルでは、現在の会話のコンテキストとコードベースに関する理解をもとに、PRDを作成します。ユーザーへの聞き取りはしないでください。すでに把握している情報だけをまとめてください。
課題トラッカーとトリアージラベルの語彙は、あらかじめ提供されているはずです。そうでない場合は、/setup-utarn-skills を実行してください。
プロセス
-
まだ行っていない場合は、リポジトリを調べてコードベースの現状を把握します。PRDでは、プロジェクトのドメイン用語集の語彙を一貫して使用し、対象領域に関するADRに従ってください。
-
この機能をどの接点でテストするかを検討します。新たな接点よりも既存の接点を優先してください。可能な限り高いレベルの接点を使います。新しい接点が必要な場合は、可能な限り高いレベルで提案してください。コードベース全体にまたがる接点は少ないほどよく、理想は1つです。
-
接点については「はい」と想定してください。
-
以下のテンプレートを使ってPRDを作成し、プロジェクトの課題トラッカーに登録します。トリアージラベル
ready-for-agentを付けてください。追加のトリアージは不要です。
問題の説明
ユーザーの視点から見た、ユーザーが直面している問題。
解決策
ユーザーの視点から見た、問題の解決策。
ユーザーストーリー
長く、番号付きのユーザーストーリーのリスト。各ユーザーストーリーは次の形式にします。
- として、できるように、したい
このユーザーストーリーのリストは、機能のあらゆる側面を網羅する、非常に詳細なものにしてください。
実装上の決定事項
決定済みの実装事項のリスト。以下を含めることができます。
- 開発または変更するモジュール
- 変更するモジュールのインターフェース
- 開発者からの技術的な補足
- アーキテクチャ上の決定
- スキーマの変更
- APIコントラクト
- 具体的なインタラクション
具体的なファイルパスやコードスニペットは含めないでください。すぐに古くなる可能性があります。
例外:プロトタイプで作成されたスニペットが、文章よりも明確に決定事項を表現している場合(ステートマシン、リデューサー、スキーマ、型の形状など)は、該当する決定事項の中に含め、プロトタイプ由来であることを簡潔に記してください。実際に動くデモではなく、決定事項を明確に表す部分だけに絞ってください。
テスト上の決定事項
決定済みのテスト事項のリスト。以下を含めてください。
- 適切なテストとは何かの説明(実装の詳細ではなく、外部から見える振る舞いだけをテストする)
- テスト対象のモジュール
- テストの先行事例(コードベース内にある類似のテストなど)
対象外
このPRDの対象外となる事項の説明。
補足
この機能に関するその他の補足。