mcpField
R
recipe-plan

recipe-plan

github.com/shinpr開発70540 回インストール6 日前に更新
リポジトリ

recipe-plan について

recipe-planは、設計書の選定、テストスケルトンの生成、作業計画の作成とレビューを調整する計画フェーズ向けスキルです。実装準備を進めるチームを対象とし、計画の承認を実行許可への引き継ぎ点とします。

主な機能

  1. 01設計書の選定
  2. 02受け入れテストスケルトンの生成
  3. 03専門エージェントによる作業計画の作成
  4. 04作業計画のレビューと修正の振り分け
  5. 05実装許可前の承認

活用シーン

  1. 01承認済み設計を実装計画に落とし込む
  2. 02設計書からテストスケルトンを生成する
  3. 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 を読んでください。

実行プロトコル:

  1. 成果物作成は指定された専門担当者に依頼する — 担当者間でデータを渡し、結果を検証してください
  2. subagents-orchestration-guide スキルの計画フローに厳密に従う:
    • 以下に定義された手順を実行する
    • 完了前に計画内容の承認を得て停止する
  3. 範囲:以下の「スコープの境界」を参照してください

以下の各 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: create
  • designDoc: [選定した 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、根拠となる要件、および証拠をこの完了時の応答に追記します。

コメント