mcpField
T
to-prd

to-prd

github.com/utarn開発4976 回インストール8 週間前に更新
リポジトリ

to-prd について

to-prd は、会話の文脈とコードベースの理解を PRD にまとめ、プロジェクトの課題トラッカーへ公開する開発スキルです。リポジトリ調査、テスト箇所、ユーザーストーリー、実装・テスト方針を扱う手順を定めています。

主な機能

  1. 01文脈を統合して PRD を作成
  2. 02リポジトリを調査しドメイン用語を採用
  3. 03テスト箇所を特定し承認済みとして扱う
  4. 04詳細な PRD テンプレートを使用
  5. 05トリアージラベルを付けてトラッカーに公開

活用シーン

  1. 01既存の議論から機能提案を文書化
  2. 02リポジトリの慣習に沿った PRD 作成
  3. 03Agent 向けの課題をトラッカーに登録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/utarn/engineer-skills --skill to-prd

インストール後、Claude Code で/to-prdを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

このスキルでは、現在の会話のコンテキストとコードベースに関する理解をもとに、PRDを作成します。ユーザーへの聞き取りはしないでください。すでに把握している情報だけをまとめてください。

課題トラッカーとトリアージラベルの語彙は、あらかじめ提供されているはずです。そうでない場合は、/setup-utarn-skills を実行してください。

プロセス

  1. まだ行っていない場合は、リポジトリを調べてコードベースの現状を把握します。PRDでは、プロジェクトのドメイン用語集の語彙を一貫して使用し、対象領域に関するADRに従ってください。

  2. この機能をどの接点でテストするかを検討します。新たな接点よりも既存の接点を優先してください。可能な限り高いレベルの接点を使います。新しい接点が必要な場合は、可能な限り高いレベルで提案してください。コードベース全体にまたがる接点は少ないほどよく、理想は1つです。

  3. 接点については「はい」と想定してください。

  4. 以下のテンプレートを使ってPRDを作成し、プロジェクトの課題トラッカーに登録します。トリアージラベル ready-for-agent を付けてください。追加のトリアージは不要です。

問題の説明

ユーザーの視点から見た、ユーザーが直面している問題。

解決策

ユーザーの視点から見た、問題の解決策。

ユーザーストーリー

長く、番号付きのユーザーストーリーのリスト。各ユーザーストーリーは次の形式にします。

  1. として、できるように、したい
1. モバイルバンキングの顧客として、支出についてより適切な判断を下せるように、自分の口座残高を確認したい

このユーザーストーリーのリストは、機能のあらゆる側面を網羅する、非常に詳細なものにしてください。

実装上の決定事項

決定済みの実装事項のリスト。以下を含めることができます。

  • 開発または変更するモジュール
  • 変更するモジュールのインターフェース
  • 開発者からの技術的な補足
  • アーキテクチャ上の決定
  • スキーマの変更
  • APIコントラクト
  • 具体的なインタラクション

具体的なファイルパスやコードスニペットは含めないでください。すぐに古くなる可能性があります。

例外:プロトタイプで作成されたスニペットが、文章よりも明確に決定事項を表現している場合(ステートマシン、リデューサー、スキーマ、型の形状など)は、該当する決定事項の中に含め、プロトタイプ由来であることを簡潔に記してください。実際に動くデモではなく、決定事項を明確に表す部分だけに絞ってください。

テスト上の決定事項

決定済みのテスト事項のリスト。以下を含めてください。

  • 適切なテストとは何かの説明(実装の詳細ではなく、外部から見える振る舞いだけをテストする)
  • テスト対象のモジュール
  • テストの先行事例(コードベース内にある類似のテストなど)

対象外

このPRDの対象外となる事項の説明。

補足

この機能に関するその他の補足。

コメント