mcpField
G
generar-prd-conversacional

generar-prd-conversacional

github.com/adminoryslabs開発045 回インストール2 日前に更新
リポジトリ

generar-prd-conversacional について

PRD.mdを8つのセクションに分け、対話を通じて確認しながら作成するスキルです。選択肢のトレードオフとエージェントの仮定を明示し、レビュー可能な仕様を作りたいチームに向いています。

主な機能

  1. 018つのセクションを順に対話
  2. 02重要な判断の選択肢とトレードオフ
  3. 03確認用にエージェントの仮定を明示
  4. 04検証後にPRD.mdを作成

活用シーン

  1. 01実装前のプロダクト要件整理
  2. 02スコープと成功基準の決定
  3. 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行で述べます。
  2. 掘り下げ:具体的な質問を1〜3個します。セクションに実質的な選択肢がある場合は、質問の前にトレードオフとともに2〜3個の選択肢を提示します。ガイドはreferences/secciones-guia.mdを参照してください。
  3. 確認:理解した内容を言い換えて1行で確認し、確定する前に調整したいか尋ねます。
  4. 確定:回答を記録し、次のセクションに進みます。情報をため込まず、PRDは進行に合わせてユーザーの頭の中で形作られていきます。

8つのセクションと、順番および想定されるやり取りの種類は次のとおりです。

#セクション種類選択肢あり?
1問題実質的な選択(捉え方)はい
2対象ユーザー実質的な選択(セグメント)はい
3目標/期待される成果実質的な選択(アウトカムとアウトプット)はい
4スコープ実質的な選択(境界)はい
5スコープ外収集(アンチパターンあり)いいえ
6成功基準実質的な選択(測定対象)はい
7エッジケース収集いいえ
8前提とリスク収集いいえ

8つのセクションすべての確認が済んだら、次のようにします。

  1. assets/prd-template.mdを使ってPRD.mdを組み立てます。テンプレートは構成や見出しを変更せず、そのままコピーします。
  2. 各セクションに確認済みの回答を記入します。エージェントによる暗黙の前提が残っている場合は、``で示します。
  3. ユーザーが別のパスを指定しない限り、プロジェクトのルートにあるPRD.mdに書き込みます。
  4. 最後に、PRDは構造化されたドラフトであり、実際のレビュー(曖昧さ、数値、境界)は引き続き人間が行う必要があることを伝えます。

品質ゲート

終了前に、次の点を表立って示さず確認します。

  • 8つのセクションがすべて含まれていること。空のセクションがないこと。最小限でも箇条書きまたはアイデアが1つあること。
  • 「スコープ外」に、少なくとも1つの明示的な除外事項があること(「上記に記載されていないものすべて」は不可)。
  • 成功基準が検証可能であり、測定の根拠がない形容詞だけになっていないこと。
  • エージェントによるすべての前提が``で示されていること。
  • すべてのセクションを完了する前に終了した場合、残りのセクションがファイル内で``と示されていること。

参考資料

  • assets/prd-template.md — そのまま使用するテンプレート。変更しないでください。generar-prdのものと同一です。
  • references/secciones-guia.md — セクションごとの掘り下げガイド。具体的な質問、トレードオフを伴う選択肢、アンチパターン、良い回答例と悪い回答例が含まれています。

コメント