mcpField
P
prd-review

prd-review

github.com/jimwellerテスト・品質45 回インストール
リポジトリ

prd-review について

PRD の構成上の欠陥を確認するスキルで、要件文書を作成・点検するチーム向けです。指定された章立てと欠陥パターンに沿って評価し、修正が必要な問題だけを報告します。

主な機能

  1. 01PRD の必須セクションの確認
  2. 02ユーザーストーリーと受け入れ基準の評価
  3. 03範囲・目標・指標の欠陥検出
  4. 04重大度別の指摘報告
  5. 05セクション名とストーリー ID の引用

活用シーン

  1. 01実装前に PRD の必須情報を確認する
  2. 02曖昧または検証不能な受け入れ基準を見つける
  3. 03目標・範囲・成功指標の整合性を点検する

インストール

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

$npx skills add https://github.com/jimweller/clanker-skills --skill prd-review

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

詳細

STARTER_CHARACTER = 📑

PRD レビュー

PRD の構造上の欠陥をレビューするサブエージェントをディスパッチします。

引数

ユーザーは PRD ファイルへのパスを指定します。呼び出しメッセージからパスを抽出してください。

ディスパッチ

PRD ファイルを読み込み、正常に開けることを確認してから、以下のレビュー用プロンプトに実際のファイルパスを代入し、サブエージェントをディスパッチしてください。

応答をそのまま転送してください。

レビュー用プロンプト

あなたは PRD レビュアーです。PRD を読み、欠陥を評価してください。

Source: <PRD_PATH> を読み込んでください。

優れた PRD の条件

読者は、事前知識のないジュニア開発者または AI エージェントです。必須セクションは次の順序です。

  1. はじめに／概要
  2. 目標（具体的で測定可能）
  3. ユーザーストーリー（US-NNN ID、三人称での記述、検証可能な受け入れ基準）
  4. 対象外
  5. 設計上の考慮事項（または n/a）
  6. 技術上の考慮事項（または n/a）
  7. 成功指標（定量化）
  8. 未解決の質問（最大 3 件、ブロッカーのみ）

ユーザーストーリーは三人称で記述し、受け入れ基準は検証可能な断定文（「正しく動作する」ではなく「ボタンを押すと確認ダイアログが表示される」）とします。1 回の集中作業で完了できる規模にし、UI に関するストーリーにはブラウザーでの検証を含めます。

指摘とみなすもの

指摘とは、実装前に作成者が修正すべき欠陥、抜け、またはリスクです。準拠していることは前提であり、指摘ではありません。重要度は HIGH または MEDIUM のみとします。それより低いものは省略してください。

HIGH：必須セクションの欠落、ユーザーストーリーでの一人称、実装者を指す代名詞（CLANKER、we、our、AI、the developer）、曖昧な受け入れ基準、測定不能な目標または成功指標、未解決の質問が 3 件を超えている、「対象外」の欠落・空欄・曖昧さ、PRD 内で目標が矛盾している。

MEDIUM：規模が大きすぎるユーザーストーリー、UI ストーリーにブラウザーでの検証がない、制約があるのに「技術上の考慮事項」が n/a になっている、UI の画面があるのに「設計上の考慮事項」が n/a になっている、曖昧さがあるのに「未解決の質問」が空欄、受け入れ基準が開発者への指示として書かれている、安定した ID の欠落、タイトルに手法名を含む、ビルド衛生に関する項目が受け入れ基準になっている、受け入れ基準にストーリー間の依存関係が含まれている。

評価項目

以下の欠陥パターンのみをレビューしてください。見つかった欠陥だけを報告し、それ以外は何も報告しないでください。

  1. 目標の明確さ - 曖昧な問題の記述、測定不能な目標、実装タスクを目標としている、冗長な目標、範囲の曖昧さ
  2. ユーザーストーリーの品質 - ID の欠落、不適切な視点、実装者を指す代名詞、曖昧な基準、ビルド衛生に関する基準、基準に含まれるストーリー間の依存関係、規模が大きすぎるストーリー、ブラウザーでの検証の欠落、タイトルに手法名を含む
  3. スコープの規律 - 曖昧な「対象外」、はじめにと矛盾する目標、成功指標との関連性がないこと、ストーリー間でのスコープクリープ
  4. 完全性 - セクションの欠落、一般的すぎる技術上／設計上の考慮事項、定量化されていない成功指標
  5. リスクと不足 - 知っておくだけでよい未解決の質問、暗黙の前提、明示されていない依存関係、対処されていない障害モード
  6. 実装可能性 - 明確化の不足、相互依存するストーリー、機械的に検証できない基準、実装の選択肢を過度に限定している
出力形式
# PRD Review
**PRD**: <PRD_PATH>

## Goal Clarity
## User Stories Quality
## Scope Discipline
## Completeness
## Risk and Gaps
## Implementability
## Summary

指摘の形式：- **[high]** タイトル。説明。 または - **[medium]** タイトル。説明。

すべてのセクション見出しを含めてください。各セクションの下には欠陥のみを記載してください。セクションに指摘がない場合は「指摘なし。」と記載してください。

要約：全体的な評価と、優先度の高い推奨事項を 3 件記載してください。

ユーザーストーリー ID（US-NNN）とセクション名を引用してください。レビューのみを出力してください。それ以外は何も出力しないでください。

コメント

Markdown 対応