generar-prd-conversacional について
PRD.mdを8つのセクションに分け、対話を通じて確認しながら作成するスキルです。選択肢のトレードオフとエージェントの仮定を明示し、レビュー可能な仕様を作りたいチームに向いています。
主な機能
- 018つのセクションを順に対話
- 02重要な判断の選択肢とトレードオフ
- 03確認用にエージェントの仮定を明示
- 04検証後にPRD.mdを作成
活用シーン
- 01実装前のプロダクト要件整理
- 02スコープと成功基準の決定
- 03レビュー可能なプロダクト仕様の作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ adminoryslabs/ armory --skill generar-prd-conversacionalインストール後、Claude Code で/generar-prd-conversacionalを入力して読み込まれたか確認します。
同梱ファイルassets/prd-template.mdreferences/secciones-guia.md
詳細
PRD ジェネレーター(対話型)
目標
ユーザーと一緒に一度に1セクションずつ進めながら、技術設計や実装にそのまま活用できる PRD.md を作成します。1回で済ませる軽量版のスキル generar-prd とは異なり、このスキルでは次のことを行います。
- 各セクションを書く前にヒアリングします。推測したり、プレースホルダーで埋めたりしません。
- 実際に判断が必要なセクション(問題の捉え方、成功の定義、対象範囲など)では、トレードオフを含む選択肢を提示します。
- エージェントの
前提に印を付け、人間がレビュー時に検証できるようにします。 - 8つのセクションがすべて検証された後、最後に
PRD.mdを作成します。途中では作成しません。
出力されるのは、ユーザーが内容を説明できるPRDです。書き直しが必要な不透明なドラフトではありません。
利用条件
ユーザーがガイド付きで段階的に進めるPRDを明示的に求めた場合、または「PRDを一緒に作ろう」「コーディングを始める前にこの製品をきちんと定義したい」「対話しながら製品仕様をまとめたい」などの言葉で始めた場合に、このスキルを使用します。ユーザーが開始用の簡単なドラフトだけを希望している場合は、軽量版のスキル generar-prd を使用します。
絶対ルール
- テンプレートの順序どおりに8つのセクションを進めます。セクションを飛ばしたり、順序を入れ替えたりしないでください。
- 各セクションを書く前に、ユーザーの返答を待ちます。ユーザーの入力なしにセクションを書くことは、このスキルの失敗パターンです。軽量モードに戻るのと同じです。
- 問題、ユーザー、成果をでっち上げないでください。ユーザーが明確に把握していない場合は、質問して見つける手助けをしてください。決して推測しないでください。
- エージェントの前提にはすべて、インラインで `` の印を付けます。PRDはレビューできる状態にし、完成品として提示できるものにしないでください。
- 選択肢は、対象プロジェクトで実際に実行可能なものにしてください。判断を提示せずに片付けるような、マニュアル的な選択肢にはしないでください。
- ユーザーが途中で会話を終了する場合は、検証済みのセクションを残し、その他のセクションに `` の印を付けた状態で、途中までの内容を
PRD.mdに保存します。
判断基準
| 状況 | 対応 |
|---|---|
| ユーザーが簡単なドラフトを求めている | このスキルではなく、generar-prd(軽量版)を使用する |
| ユーザーにアイデアはあるが、問題が明確ではない | 問題セクションに進み、質問して明確化を手助けする。次のセクションには進まない |
| ユーザーがすべて明確に把握しており、速く進めたい | 短い回答を受け入れる。十分な回答を無理に詳しくさせない |
| 実際の判断が必要なセクション(問題、成功、対象範囲) | 回答を受け入れる前に、トレードオフを含む2~3個の選択肢を提示する |
| 情報を拾い上げるセクション(前提、境界ケース) | 選択肢は提示せず、掘り下げる質問を1~2個する |
| ユーザーがすでにPRDを持っており、レビューを希望している | このスキルは使用しない。既存の PRD.md を開いてもらい、セクションごとに一緒にレビューする |
ワークフロー
始める前に、ユーザーが対話形式のフローを希望していることを確認します。希望する場合は、8つのセクションを順番に1ターンにつき1つ進めます。各セクションでは、次のようにします。
- 導入:チュートリアルにはせず、そのセクションが重要な理由を1行で述べます。
- 掘り下げ:具体的な質問を1〜3個します。セクションに実質的な選択肢がある場合は、質問の前にトレードオフとともに2〜3個の選択肢を提示します。ガイドは
references/secciones-guia.mdを参照してください。 - 確認:理解した内容を言い換えて1行で確認し、確定する前に調整したいか尋ねます。
- 確定:回答を記録し、次のセクションに進みます。情報をため込まず、PRDは進行に合わせてユーザーの頭の中で形作られていきます。
8つのセクションと、順番および想定されるやり取りの種類は次のとおりです。
| # | セクション | 種類 | 選択肢あり? |
|---|---|---|---|
| 1 | 問題 | 実質的な選択(捉え方) | はい |
| 2 | 対象ユーザー | 実質的な選択(セグメント) | はい |
| 3 | 目標/期待される成果 | 実質的な選択(アウトカムとアウトプット) | はい |
| 4 | スコープ | 実質的な選択(境界) | はい |
| 5 | スコープ外 | 収集(アンチパターンあり) | いいえ |
| 6 | 成功基準 | 実質的な選択(測定対象) | はい |
| 7 | エッジケース | 収集 | いいえ |
| 8 | 前提とリスク | 収集 | いいえ |
8つのセクションすべての確認が済んだら、次のようにします。
assets/prd-template.mdを使ってPRD.mdを組み立てます。テンプレートは構成や見出しを変更せず、そのままコピーします。- 各セクションに確認済みの回答を記入します。エージェントによる暗黙の前提が残っている場合は、``で示します。
- ユーザーが別のパスを指定しない限り、プロジェクトのルートにある
PRD.mdに書き込みます。 - 最後に、PRDは構造化されたドラフトであり、実際のレビュー(曖昧さ、数値、境界)は引き続き人間が行う必要があることを伝えます。
品質ゲート
終了前に、次の点を表立って示さず確認します。
- 8つのセクションがすべて含まれていること。空のセクションがないこと。最小限でも箇条書きまたはアイデアが1つあること。
- 「スコープ外」に、少なくとも1つの明示的な除外事項があること(「上記に記載されていないものすべて」は不可)。
- 成功基準が検証可能であり、測定の根拠がない形容詞だけになっていないこと。
- エージェントによるすべての前提が``で示されていること。
- すべてのセクションを完了する前に終了した場合、残りのセクションがファイル内で``と示されていること。
参考資料
assets/prd-template.md— そのまま使用するテンプレート。変更しないでください。generar-prdのものと同一です。references/secciones-guia.md— セクションごとの掘り下げガイド。具体的な質問、トレードオフを伴う選択肢、アンチパターン、良い回答例と悪い回答例が含まれています。
コメント
Markdown 対応