prd-quality-gate について
エージェント実行前に要件と実装計画を確認する読み取り専用のゲートです。ドラフトの lint と実行準備の判定を分け、判定、根拠、具体的なブロッカーを返します。
主な機能
- 01要件ドラフトの lint
- 02実行準備状況の判定
- 03受け入れ条件の確認
- 04リポジトリ証拠の調査
- 05ブロッカーと対応担当の報告
活用シーン
- 01計画前の要件レビュー
- 02エージェントへの引き渡し前の計画確認
- 03未決の実装判断の特定
- 04確認項目と証拠の最新性確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shipshitdev/ skills --skill prd-quality-gateインストール後、Claude Code で/prd-quality-gateを入力して読み込まれたか確認します。
同梱ファイルreferences/execution-readiness.md
詳細
PRD 品質ゲート
契約
入力:
- 要件、実装計画、対象リポジトリ、および指定されたモード。
- 実行が要求された場合は、最新のイシュー本文/コメントとリポジトリのリビジョン。
出力:
draft-lint:不完全な要件に対する警告。実行許可は決して付与しません。execution-readiness:READYまたはBLOCKED、各チェックの根拠、および具体的な不足事項。
作成/変更:
- 実装やトラッカーの変更は行いません。調査結果を呼び出し元のエンジンに返します。
外部への副作用:
- リポジトリとトラッカーの読み取り専用の調査。
確認の要否:
- 読み取り専用の検証では不要です。呼び出し元のアクセス制限を遵守してください。
共通の契約
検証または準備テンプレートの提供を行う前に、Execution readiness を読んでください。このリファレンスが、要件テンプレート、計画テンプレート、分解ルール、判断基準、および準備状況チェックリストを管理します。利用側は、兄弟パス ../prd-quality-gate/references/execution-readiness.md からこのリファレンスを読み込みます。別のコピーを管理しないでください。
要件のみのレビューが明示的に求められた場合は、draft-lint を使用してください。必須の見出し、空でないスコープ、および EARS 形式の受け入れ基準を確認し、不足情報を警告として報告します。ドラフトの lint は、プランナーが調査を続ける際に役立ちます。すべての見出しが存在していても、イシューを実行担当者向けに準備完了と判定することはできません。
feature-intake、実行の引き継ぎ、AFK 分類、または作業をエージェント向けに準備完了と宣言する要求では、ブロッキング型の execution-readiness を使用してください。これらの状況でモードが指定されていない場合は、execution-readiness とします。それ以外の場合は draft-lint をデフォルトとし、その制限を出力に明記してください。
意味と根拠を検証する
実際の動作、完了した判断、リポジトリの根拠、検証の実行可能性、および情報の鮮度を確認してください。見出しや EARS の文法だけでは、準備完了と判断できません。ソースファイルとコマンド定義を読み、確認済みの事実と提案された変更を区別してください。実行担当者の判断を要する不明点は不合格としてください。
番号付きまたはチェックボックス形式の受け入れ項目を受け入れます。EARS を確認する前に、マーカーと任意の AC-N: 接頭辞を取り除いてください。観測可能な応答を伴う WHEN、WHILE、WHERE、IF ... THEN、または THE SYSTEM SHALL 形式を受け入れます。計画から検証へのマッピングで使う安定した ID を、各基準に付与してください。主観的な合格条件や、見出しを単に繰り返すだけの基準は却下してください。
検証モード、判定結果、イシュー/計画の識別情報、調査したリビジョン、合格したチェック、および是正担当者を含むブロッカーを返してください。不足しているチェックや実行できないチェックは、推測で合格とせず BLOCKED としてください。ブロックされたドラフトは、許可された範囲内で保存できますが、プランナーが修正するまで実行可能な経路には載せないでください。