blueprint-prp-execute

/blueprint:prp-execute

体系的な実装、検証ゲート、TDD ワークフロー、品質保証を用いて PRP（製品要件プロンプト）を実行します。

使用方法：/blueprint:prp-execute [prp-name]

前提条件：

• PRP が docs/prps/[prp-name].md に存在すること
• 信頼度スコアが 7 以上であること（7 未満の場合は、改善のために /blueprint:prp-create を提案します）

詳細なレポートテンプレート、延期項目のワークフロー、機能トラッカーの同期、エラー処理パターンについては、REFERENCE.md を参照してください。

このスキルを使用する場合

このスキルを使用する場合...	代替手段を使用する場合...
PRP に基づいて計画済みの機能を実装する準備ができている	PRP の準備がまだ整っていない（信頼度 < 7）
完全な検証と TDD ワークフローを実行したい	ドキュメントなしで場当たり的な機能を実装する
機能トラッカーと GitHub の課題管理が必要	独立したバグ修正に取り組む
進捗の自動レポートと延期項目の追跡を行いたい	正式な追跡なしで素早くプロトタイピングする

コンテキスト

• PRP ファイルのパス： !find . -maxdepth 1 -name \'docs/prps/${1:-unknown}.md\'
• PRP の信頼度スコア： !find . -path '*/docs/prps/*' -maxdepth 3 -name "${1:-unknown}.md" -exec grep -m1 "^confidence:" {} +
• 機能トラッカーの有効化状態： !find . -path '*/docs/blueprint/*' -maxdepth 3 -name 'feature-tracker.json' -type f
• 現在のブランチ： !git rev-parse --abbrev-ref HEAD
• 未コミットの変更： !git status --porcelain

パラメーター

$ARGUMENTS を解析します：

• prp-name（必須）：docs/prps/ にある PRP ファイルの名前（.md 拡張子なし）
  • 例：feature-auth-oauth2 → docs/prps/feature-auth-oauth2.md を読み込みます

実行

PRP の実装ワークフロー全体を実行します：

ステップ 1：PRP の読み込みと検証

1. PRP ファイルを読み込みます：docs/prps/{prp-name}.md
2. フロントマターから信頼度スコアを抽出します
3. 信頼度 < 7 の場合 → エラー：「PRP の信頼度が低すぎます。改善するには /blueprint:prp-create {prp-name} を実行してください」
4. 信頼度 >= 9 の場合 → 委任を提案します：「この PRP の信頼度は高いです。今すぐ実行しますか（現在のセッション）、それとも委任用の作業指示書を作成しますか？」
   • 作業指示書を選択した場合 → /blueprint:work-order --from-prp {prp-name} を実行して終了します
   • 複数のサブエージェントへの委任を選択した場合 → Implementation Blueprint に基づいて、モジュールごとに個別の作業指示書を作成して終了します
5. 今すぐ実行する場合、または信頼度が 7～8 の場合は、ステップ 2 に進みます
6. 参照されているキュレーション済みルールのエントリー（.claude/rules/）をすべて読み込み、コンテキストとして使用します
7. Implementation Blueprint を解析し、依存関係順に TodoWrite のエントリーを作成します

ステップ 2：検証ゲートでベースラインを確立

実装前の検証ゲートを実行し（REFERENCE.md を参照）、クリーンな開始状態を確立します：

1. リンティングゲート：[command from PRP] - 期待値：PASS
2. 既存テストゲート：[command from PRP] - 期待値：PASS

ゲートに失敗した場合：

• 既存の問題を記録します
• 先に修正するか、注記を添えて続行するかを決定します
• 準備ができたら続行します

ステップ 3：TDD 実装サイクルを実行

Implementation Blueprint の各タスクについて：

1. RED フェーズ：PRP の TDD 要件に合致する失敗するテストを作成します

   • 必要に応じてテストファイルを作成します
   • テストを実行し、失敗を確認します（テストに意味があることを確認）

2. GREEN フェーズ：テストに合格する最小限のコードを実装します

   • PRP に記載された Codebase Intelligence のパターンに従います
   • キュレーション済みルールの参照先にあるパターンを適用します
   • 既知の落とし穴に注意します
   • テストを実行し、成功を確認します

3. REFACTOR フェーズ：テストを成功状態に保ちながらコードを改善します

   • 共通パターンを抽出します
   • 命名を改善し、型ヒントを追加します
   • プロジェクトの規約に従います
   • テストを実行し、PASS を確認します
   • 検証ゲートを頻繁に実行します（最後だけでなく）

4. 進捗を記録：TodoWrite を更新します：✅ Task N: [Description]

Step 4: 包括的な最終検証を実行する

PRP のすべての検証ゲートを実行します（REFERENCE.mdを参照）。

• リント：[cmd] - 期待値：PASS
• 型チェック：[cmd] - 期待値：PASS
• 単体テスト：[cmd] - 期待値：PASS（すべてのテスト）
• 統合テスト：[cmd] - 期待値：PASS（該当する場合）
• カバレッジチェック：[cmd] - 期待値：しきい値を満たす
• セキュリティスキャン：[cmd] - 期待値：高または重大な問題がない（該当する場合）
• パフォーマンステスト：[cmd] - 期待値：ベースラインを満たす（定義されている場合）

PRP の各成功基準を確認します。

Step 5: 保留項目を記録する

保留中の作業を特定し、追跡します。

1. Implementation Blueprint を確認し、未完了の項目を特定します
2. 保留項目をそれぞれ分類します。
   • Phase 2（必須）：GitHub の Issue を作成する必要があります
   • あると望ましい項目：任意です。Issue の作成は不要です
   • ブロック中：完了できません。ブロッカーを記録し、Issue を作成します
3. Phase 2 とブロック中の項目すべてについて GitHub の Issue を作成します（REFERENCE.mdを参照）
4. GitHub の Issue へのリンクを含む保留項目セクションを PRP に追加します
5. 必要な Issue をすべて作成するまで、Step 6 に進まないでください

Step 6: 機能トラッカーを同期する（有効な場合）

機能トラッカー（docs/blueprint/feature-tracker.json）がある場合：

1. PRP で対応した機能コード（例：FR2.1）を特定します
2. 各コードについて、機能トラッカーを更新します。
   • ステータス：complete（すべての基準を満たす）、partial（一部の基準を満たす）、または in_progress
   • ファイル：変更または作成したファイルの一覧
   • テスト：テストファイルの一覧
   • コミット：コミットハッシュ
   • メモ：実装に関するメモ
3. 統計を再計算します：完了率、フェーズのステータス
4. TODO.md を更新します：完了した機能のチェックボックスにチェックを入れます
5. 機能トラッカーの変更内容を報告します

Step 7: 結果と次のステップを報告する

包括的な実行サマリーレポートを作成します。

• 完了したタスク：X/Y
• 追加したテスト：N
• 変更したファイル：[一覧]
• 検証結果：すべてのゲートの表（PASS/FAIL のステータス）
• 成功基準：すべて確認済み
• 保留項目の概要：件数と GitHub の Issue 番号
• 機能トラッカーの更新：更新した機能と割合
• 新たに見つかった注意点：[今後の参照用に記録]
• 推奨事項：フォローアップ作業またはキュレーション済みルールの更新

次のアクションをユーザーに確認します。

• 変更をコミットする（推奨）→ /git:commit を実行
• フォローアップ用の work-order を作成する → /blueprint:work-order を実行
• パターンをキュレーション済みルールとして記録する → /blueprint:curate-docs を実行
• 次の PRP に進む → /blueprint:prp-execute [next] を実行
• 今回はここまで → 終了

エージェント最適化

コンテキスト	コマンド
PRP が存在するか確認	test -f docs/prps/${1}.md && echo "EXISTS" || echo "MISSING"
信頼度を抽出	head -50 docs/prps/${1}.md | grep -m1 "^confidence:" | sed 's/^[^:]*:[[:space:]]*//'
すべての PRP を一覧表示	ls docs/prps/*.md 2>/dev/null | xargs basename -s .md
機能トラッカーを確認	test -f docs/blueprint/feature-tracker.json && echo "YES" || echo "NO"
高速検証	可能な場合は検証ゲートを並列で実行

---

検証ゲートの詳細な定義、保留項目のワークフロー、エラー処理の手順、エージェントチームの連携については、REFERENCE.mdを参照してください。