mcpField
E
executing-plans

executing-plans

github.com/hjewkesエージェントワークフロー436 回インストール35 週間前に更新
リポジトリ

executing-plans について

実装計画を確認し、小さなバッチに分けて実行するスキルです。計画ファイルを使うエージェント向けで、実行前の批判的な確認と、バッチ間のレビューを重視します。

主な機能

  1. 01計画と現在のタスク説明を読み込む
  2. 02計画の懸念点を確認する
  3. 03タスクをバッチ単位で実行する
  4. 04バッチ間でレビューを待つ
  5. 05成功基準に沿ってタスクを検証する

活用シーン

  1. 01複数タスクの計画を段階的に実装
  2. 02コード変更前に計画上の懸念を提示
  3. 03実装バッチ間でアーキテクトの意見を得る

インストール

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

$npx skills add https://github.com/hjewkes/agent-skills --skill executing-plans

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

同梱ファイルreferences/guardrails.md

詳細

計画の実行

概要

計画を読み込み、批判的にレビューし、タスクをバッチ単位で実行して、バッチ間でレビューを依頼します。

基本原則: アーキテクトのレビュー用チェックポイントを設けて、バッチ単位で実行します。

開始時に宣言: 「計画を実行するスキルを使って、この計画を実装します。」

プロセス

ステップ 1:計画の読み込みとレビュー

計画ディレクトリの形式(.claude/plans/<plan-id>/):

  1. plan.md のオーケストレーション計画と manifest.json を読み込みます
  2. 現在のバッチに含まれる各タスクについて、briefings/task-NN.md のブリーフィングファイルを読み込みます
  3. 現在のバッチのブリーフィングのみを読み込みます(デフォルトは 3 件)。すべてのタスクを一度に読み込まないでください
  4. 批判的にレビューし、計画に関する疑問や懸念事項を特定します
  5. 懸念事項がある場合:着手する前に人間のパートナーに伝えます
  6. 懸念事項がない場合:TodoWrite を作成して進めます

従来の一体型形式(docs/plans/*.md):

  1. 計画ファイルを直接読み込みます
  2. 同じレビューとバッチのプロセスに従います

形式の判定: パスに manifest.json が含まれる場合、またはディレクトリを指している場合は、計画ディレクトリ形式を使用します。.md ファイルを指している場合は、従来の形式を使用します。パスが指定されていない場合は、.claude/plans/ で最も新しいディレクトリを確認し、なければ docs/plans/ で最も新しい .md ファイルを確認します。

ステップ 2:バッチの実行

デフォルト:最初の 3 タスク

各タスクについて:

  1. ステータスを in_progress にします
  2. ブリーフィングファイルの手順(簡潔なステップ)に正確に従います
  3. ブリーフィングの成功基準に指定された検証を実行します
  4. ステータスを completed にします
ステップ 3:報告

バッチが完了したら:

  • 実装した内容を示します
  • 検証結果を示します
  • 「フィードバックをお待ちしています。」と伝えます
ステップ 4:続行

フィードバックに基づいて:

  • 必要に応じて変更を適用します
  • 次のバッチを実行します(次のバッチのブリーフィングファイルを読み込みます)
  • 完了するまで繰り返します
ステップ 5:開発の完了

すべてのタスクが完了し、検証されたら:

  1. 計画ディレクトリ形式を使用している場合は、後片付けをします:
    • 必要に応じて、実行メモを .claude/plans/<plan-id>/summary.md に記録します
    • 計画ディレクトリを削除します:rm -rf .claude/plans/<plan-id>/
    • 削除に失敗した場合は警告しますが、作業は続行します
  2. 「この作業を完了するために、git-workflow スキルを使います。」と宣言します
  3. 必須のサブスキル: git-workflow stack を使用します
  4. このスキルに従ってテストを検証し、選択肢を提示して、選ばれた方法を実行します

ガードレール

行き詰まった場合は、推測せずに作業を止めて確認します。停止条件とチェックリストの全容は、references/guardrails.md を参照してください。

統合

必須のワークフロースキル:

  • git-workflow - 必須:分離されたワークスペースには worktrees を、開発の完了には stack を使用します
  • writing-plans - このスキルが実行する計画を作成します

コメント