executing-plans について
実装計画を確認し、小さなバッチに分けて実行するスキルです。計画ファイルを使うエージェント向けで、実行前の批判的な確認と、バッチ間のレビューを重視します。
主な機能
- 01計画と現在のタスク説明を読み込む
- 02計画の懸念点を確認する
- 03タスクをバッチ単位で実行する
- 04バッチ間でレビューを待つ
- 05成功基準に沿ってタスクを検証する
活用シーン
- 01複数タスクの計画を段階的に実装
- 02コード変更前に計画上の懸念を提示
- 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>/):
plan.mdのオーケストレーション計画とmanifest.jsonを読み込みます- 現在のバッチに含まれる各タスクについて、
briefings/task-NN.mdのブリーフィングファイルを読み込みます - 現在のバッチのブリーフィングのみを読み込みます(デフォルトは 3 件)。すべてのタスクを一度に読み込まないでください
- 批判的にレビューし、計画に関する疑問や懸念事項を特定します
- 懸念事項がある場合:着手する前に人間のパートナーに伝えます
- 懸念事項がない場合:TodoWrite を作成して進めます
従来の一体型形式(docs/plans/*.md):
- 計画ファイルを直接読み込みます
- 同じレビューとバッチのプロセスに従います
形式の判定: パスに manifest.json が含まれる場合、またはディレクトリを指している場合は、計画ディレクトリ形式を使用します。.md ファイルを指している場合は、従来の形式を使用します。パスが指定されていない場合は、.claude/plans/ で最も新しいディレクトリを確認し、なければ docs/plans/ で最も新しい .md ファイルを確認します。
ステップ 2:バッチの実行
デフォルト:最初の 3 タスク
各タスクについて:
- ステータスを in_progress にします
- ブリーフィングファイルの手順(簡潔なステップ)に正確に従います
- ブリーフィングの成功基準に指定された検証を実行します
- ステータスを completed にします
ステップ 3:報告
バッチが完了したら:
- 実装した内容を示します
- 検証結果を示します
- 「フィードバックをお待ちしています。」と伝えます
ステップ 4:続行
フィードバックに基づいて:
- 必要に応じて変更を適用します
- 次のバッチを実行します(次のバッチのブリーフィングファイルを読み込みます)
- 完了するまで繰り返します
ステップ 5:開発の完了
すべてのタスクが完了し、検証されたら:
- 計画ディレクトリ形式を使用している場合は、後片付けをします:
- 必要に応じて、実行メモを
.claude/plans/<plan-id>/summary.mdに記録します - 計画ディレクトリを削除します:
rm -rf .claude/plans/<plan-id>/ - 削除に失敗した場合は警告しますが、作業は続行します
- 必要に応じて、実行メモを
- 「この作業を完了するために、git-workflow スキルを使います。」と宣言します
- 必須のサブスキル: git-workflow stack を使用します
- このスキルに従ってテストを検証し、選択肢を提示して、選ばれた方法を実行します
ガードレール
行き詰まった場合は、推測せずに作業を止めて確認します。停止条件とチェックリストの全容は、references/guardrails.md を参照してください。
統合
必須のワークフロースキル:
- git-workflow - 必須:分離されたワークスペースには worktrees を、開発の完了には stack を使用します
- writing-plans - このスキルが実行する計画を作成します
コメント
Markdown 対応