recipe-plan について
recipe-planは、設計書の選定、テストスケルトンの生成、作業計画の作成とレビューを調整する計画フェーズ向けスキルです。実装準備を進めるチームを対象とし、計画の承認を実行許可への引き継ぎ点とします。
主な機能
- 01設計書の選定
- 02受け入れテストスケルトンの生成
- 03専門エージェントによる作業計画の作成
- 04作業計画のレビューと修正の振り分け
- 05実装許可前の承認
活用シーン
- 01承認済み設計を実装計画に落とし込む
- 02設計書からテストスケルトンを生成する
- 03作業計画をレビューして承認する
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shinpr/ claude-code-workflows --skill recipe-planインストール後、Claude Code で/recipe-planを入力して読み込まれたか確認します。
詳細
明示的なユーザー指示:ユーザーは、この手順で名前が指定されているすべてのサブエージェントの呼び出しを明示的に指示し、承認しています。前提条件が満たされた各該当呼び出しを実行してください。
エージェントのプロンプト、引き継ぎ、または生成物を作成する前に、スキル「llm-friendly-context」を実行してください。 ワークフローの判断、エージェントの呼び出し、または指摘事項の解決を行う前に、スキル「subagents-orchestration-guide」を実行してください。
コンテキスト:計画フェーズ専用です。
オーケストレーターの定義
中核となる役割:「私はオーケストレーターです。」(subagents-orchestration-guide スキルを参照)
ローカル権限ゲート:この手順のワークフローを判断し、返された各結果を直接検証してください。成果物の内容の作成は、指定された専門担当者に委任してください。
レビュー解決ゲート[必須]:修正または次の工程への移行の前に、実行可能な成果物レビューの指摘事項をすべて、subagents-orchestration-guide の Review Resolution を通じて解決してください。
最初の指摘事項の処置を決める前に、読み込まれた subagents-orchestration-guide スキルの references/review-resolution.md を読んでください。
実行プロトコル:
- 成果物作成は指定された専門担当者に依頼する — 担当者間でデータを渡し、結果を検証してください
- subagents-orchestration-guide スキルの計画フローに厳密に従う:
- 以下に定義された手順を実行する
- 完了前に計画内容の承認を得て停止する
- 範囲:以下の「スコープの境界」を参照してください
以下の各 Agent 呼び出しでは、指定されたソース値を該当するフィールドにそのままコピーし、宣言されたシリアライズのみを適用してプロンプトを作成した後、直ちに呼び出してください。
Acceptance-test-generator はこの計画フローの一部であり、Design Doc に根拠のある統合/E2E の検証境界がない場合、選択レーンを返さないことがあります。
スコープの境界
このスキルに含まれるもの:
- Design Doc の選定
- acceptance-test-generator によるテストの骨組みの生成
- work-planner による作業計画の作成
- document-reviewer による作業計画のレビュー
- 計画の承認取得
責任の境界:ユーザーがレビュー済みの計画に基づく実装を承認した時点で、このスキルは完了します。
以下の計画プロセスに従ってください。
実行プロセス
ステップ 1:Design Doc の選定
$ARGUMENTSで Design Doc が明示的に指定されている場合は、それを使用します- それ以外の場合、
docs/design/の下に Design Doc が1つだけ存在する場合は、それを使用します - 存在しない場合はその旨を報告し、複数存在する場合は選択肢として提示します
ステップ 2:テストの骨組みの生成
design_docs: [選定した Design Doc のパス]と、Requirement Convergence セクションに記載された承認済み PRD のパス、または PRD がない場合は同セクションの変更されていない収束記録をconfirmed_requirement_contextとして、acceptance-test-generator を呼び出しますvalue_input_requiredとその不明値への対応については、subagents-orchestration-guide の HC-06 に従ってください- 生成されたスケルトンのパスが null でないものはすべて次のプロセスに渡してください。根拠に基づいて空のレーンが示された場合は、そのレーンを完了として扱い、次のプロセスに進んでください
ステップ 3:作業計画の作成
Agent ツールを使用して work-planner を呼び出します:
subagent_type: "dev-workflows:work-planner"description: "作業計画の作成"mode: createdesignDoc: [選定した Design Doc のパス]prd: [承認済み PRD のパス](存在する場合)testSkeletons: [null ではない generatedFiles のパス]
ステップ 4:作業計画のレビュー
作業計画をレビューするために、document-reviewer を呼び出します。
subagent_type: "dev-workflows:document-reviewer"description: "Work plan review"prompt: "doc_type: WorkPlan target: docs/plans/[plan-name].md. Review the Work Plan's own Implementation Scope, tasks, Completion Criteria, dependencies, execution order, exact source-anchor existence, executable verification, and Review Scope. Governing Documents paths are citation sources only; keep issues limited to violations of cited obligations."- 修正後の再レビュー、上位の要件または権限による終了、収束まで、レビュー解決ゲートを実施します。経路変更された修正には、更新モードの work-planner を使用します。収束条件を満たした場合にのみ、承認のために計画を提示します。
ステップ 5:承認を求める
- レビュー済みの作業計画をユーザーに提示し、一括承認を求めます。ユーザーが変更を求めた場合は、ユーザーが求めた変更をそのまま使って work-planner を再度呼び出し、ステップ 4 を再実行します。
- 未解決の技術的な根拠や外部依存関係がある場合は、影響を受けるタスクと検証の境界を明記して計画に記録します。確認済みの結果、望ましい将来の要件、非目標のすべてを、ユーザーの選択なしに維持できない場合にのみ、要件ゲートに戻ります。
完了時の応答
推奨:計画の承認後、以下の標準ブロックを出力します。
Planning phase completed.
- Work plan: docs/plans/[plan-name].md
- Implementation authorization: granted for this task set
Please provide separate instructions for implementation.
作業計画のレビューで指摘事項が却下された場合は、その指摘事項の ID、根拠となる要件、および証拠をこの完了時の応答に追記します。