executing-plans

概要

executing-plans スキルでできること

executing-plans スキルは、「実装プランはすでに書かれていて、それをエージェントに着実に実行させたい」場面向けに設計されています。主に次の点にフォーカスしています。

• プロジェクト内の、具体的でステップごとの実装プランを読み込む
• 実装に入る前に、そのプランを批判的にレビューする
• タスクを 1 つずつ実行し、ステータスを明確に更新する
• プラン内で指定された検証やテストを実行する
• 開発が完了したら、仕上げ用ワークフローに引き継ぐ

セッション開始時、エージェントは次のように宣言することが期待されています。

"I'm using the executing-plans skill to implement this plan."

これにより、エージェントが自由なブレインストーミングやプラン作成モードではなく、構造化された実行モードに入っていることが明確になります。

このスキルが向いているユーザー

このスキルは次のような人に適しています。

• 事前に設計を済ませ、詳細なプランの実行をエージェントに任せたい 開発者
• 各機能・ブランチごとに実装プランを書き、GitHub を使っている チーム
• Claude Code や Codex のような環境で、予測しやすく再現性のある実行ワークフローを求める エージェントオペレーター
• 明示的なチェックポイントと検証ステップを含むプランへの一貫した順守を求める プロジェクトメンテナー

特に、プランがすでに 小さなステップに分割されていて、明確な検証・テスト要件が含まれている場合に有用です。

executing-plans が解決する課題

executing-plans スキルは次のような点で役立ちます。

• 事前承認済みのプランに作業をひも付けることで、行き当たりばったりで方向がぶれる実装を防ぐ
• コード変更前にプランの批判的レビューを必須にすることで、問題を早期に発見する
• タスクごとに進捗を管理し、作業を in_progress、完了後に completed と明示的にマークする
• プランで指定されている検証やテストが、実際に実行されるようにする
• 最後のテスト検証や判断は仕上げ用スキルにきれいに引き継ぐ

プランの実行方法を標準化することで、認識のズレを減らし、人間とエージェントが開発作業でより予測可能に協働できるようにします。

このスキルが適している場合・適さない場合

executing-plans を使うべきなのは、次のような場合です。

• すでに書かれた実装プランがある
• プランがタスクやステップとして順序立てて整理されている
• エージェントには主に 実行 を任せ、解決策の設計はしたくない
• 不明点やブロッカーがあれば、エージェントから積極的にヘルプを求めてほしい

別のスキルやワークフローを検討すべきなのは、次のような場合です。

• ゼロからプランを 作成する 手助けが必要（このスキルは、すでにプランがあることを前提にしています）
• プランが極端に曖昧で、重要な情報が欠けている
• プラットフォームが高度なサブエージェント機能（例: Claude Code, Codex）を備えており、よりリッチなオーケストレーションを行いたい。その場合、このリポジトリでは superpowers:subagent-driven-development の利用を推奨しています
• まだ特定の実装方針にコミットしたくなく、複数案を検討したい

またリポジトリでは、すべてのタスクを実行し終えたら、作業を締めくくるために必須サブスキル superpowers:finishing-a-development-branch へ移行することが明記されています。

使い方

インストールとセットアップ

1. executing-plans スキルをインストールする

obra/superpowers リポジトリからスキルをインストールします。

npx skills add https://github.com/obra/superpowers --skill executing-plans

これで、あなたのエージェント環境で executing-plans のワークフローが利用可能になります。

2. 実装プランを準備する

スキルを呼び出す前に、プロジェクト内に 書かれた実装プラン を用意しておきます。理想的には次のような形になっていると良いでしょう。

• エージェントが読み取れるファイル（例: リポジトリ内のファイル）として保存されている
• 個々のタスクや小さなステップに分解されている
• 各タスクごとに必要な verification や testing の手順が明記されている

プランの質と明瞭さが高いほど、executing-plans のワークフローも安定して信頼できるものになります。

コアワークフロー: プランから実行まで

Step 1: プランの読み込みとレビュー

executing-plans を使ってセッションを開始するとき、エージェントは次を行います。

1. プロジェクトから プランファイルを読み込む
2. プランを 批判的にレビュー し、次の点を確認する:
   • 情報不足や曖昧な指示がないか
   • ステップ同士に矛盾やコンフリクトがないか
   • 現実的でない前提や成立しない前提条件がないか
3. 懸念点が見つかった場合は、実行を開始する前に あなたに共有し相談する
4. 問題がなければ、エージェントは内部的な to-do 構造（例: TodoWrite）を作成し、実行の準備を整える

このレビュー工程は非常に重要です。不完全なプランに盲目的に従うことを防ぎ、早い段階で認識合わせを行うことができます。

Step 2: ステータス管理付きでタスクを実行する

プラン内の各タスクについて、executing-plans スキルは次のパターンに従うことを想定しています。

1. タスクを in_progress としてマーク し、進行中の作業を可視化する
2. プランに書かれた内容どおりに、各ステップを正確に実行する
   • プランは小さく具体的なステップで構成されていることを前提とします
   • プランが明らかに不十分な場合を除き、エージェントはむやみにアドリブで進めるべきではありません
3. プランで指定されている 検証を実行する
   • テスト、リンター、手動チェックなど、プランに記載された確認手順を含みます
4. そのタスクに必要な作業と検証がすべて完了したら、タスクを completed としてマーク する

この構造によって、人間側は進捗を追いやすくなり、エージェントも検証プロセスを飛ばしてしまうリスクを避けられます。

Step 3: 仕上げ用スキルで開発を完了させる

プラン内のすべてのタスクを実行し、検証が完了したら、次のステップに進みます。

• エージェントは次のように宣言します。

  "I'm using the finishing-a-development-branch skill to complete this work."

• そのうえで 必須サブスキル superpowers:finishing-a-development-branch を利用します

• 仕上げ用スキルのフローに従って、次を行います。

  • 必要に応じてテストの再実行や検証を行う
  • ブランチの状態や次のステップなど、最終的な選択肢や結果を提示する
  • 選択された仕上げアクションを実行する

このように executing-plans は、開発パイプラインの 中盤 を担う存在と捉えるのが自然です。書かれたプランをもとに変更を実装し、最後は専用の仕上げワークフローに引き継ぎます。

ブロッカーと不確実性への対応

どのタイミングで実行を止めてヘルプを求めるべきか

スキル定義によると、エージェントは次のような場合、即座に実行を停止し、ヘルプを求めなければなりません。

• 次のような ブロッカー に直面した場合:
  • 必要な依存関係やツールが欠けている
  • 想定外の形でテストが失敗する
  • 利用可能なコンテキストでは実行できない指示が含まれている
• 作業の開始や継続を妨げるような、プランの 重大な欠落 がある場合
• プランの一部を十分に理解できず、自信を持って先に進めない場合

このような状況では、セッションは実行モードから説明・相談モードに切り替わり、エージェントは何が進行を阻んでいるのか、あなたから何が必要なのかを説明します。

executing-plans を使うときのおすすめプラクティス

executing-plans スキルを最大限活用するには、次の点を意識すると良いでしょう。

• タスクごとに 1 つの明確な成果があるように、具体的で順序だったプラン を書く
• 主要な変更にはそれぞれ verification の手順 を含める
• 初回レビューで見つかった懸念点を、エージェントが黙って推測するのではなく、要約して共有する よう促す
• 実行後は一貫して finishing-a-development-branch スキルを使い、全体のワークフローを予測しやすく保つ

FAQ

executing-plans スキルをひと言でいうと何ですか？

executing-plans スキルは、あらかじめ書かれている実装プランをエージェントが 読み込み、レビューし、実行する ための構造化ワークフローです。タスクをステップごとに進め、指定された検証を実行し、開発が完了したタイミングで仕上げ用スキルに制御を渡します。

executing-plans スキルのインストール方法は？

obra/superpowers リポジトリから次のコマンドでインストールできます。

npx skills add https://github.com/obra/superpowers --skill executing-plans

インストール後、エージェントや実行環境が実装プランのファイルを読めるように設定し、対象のセッションで executing-plans を呼び出せるようにしておきます。

executing-plans を使うのにサブエージェントは必須ですか？

いいえ。executing-plans スキルは、サブエージェント機能が なくても 動作するよう設計されています。ただしリポジトリでは、Superpowers はサブエージェントがある環境の方がより良く機能するとしており、もしあなたのプラットフォームが（Claude Code や Codex のように）サブエージェントに対応しているなら、より高度なオーケストレーションが可能な superpowers:subagent-driven-development の利用も検討すべきだとしています。

subagent-driven development より executing-plans を優先すべきなのはどんなときですか？

次のような状況では executing-plans を使うとよいでしょう。

• 環境にサブエージェント機能がほとんどない、または全くない
• すでにあるプランを、単純で直線的な流れで実行したい
• 複雑なエージェントオーケストレーションではなく、シンプルな「レビュー → 実行 → 仕上げ」のフローを重視したい

一方、マルチエージェントでの協調、ダイナミックなタスク分割、より自律的な意思決定が必要な場合は、superpowers:subagent-driven-development が推奨される代替案です。

executing-plans と相性の良いプランはどんなものですか？

executing-plans は次のようなプランと最も相性が良いです。

• エージェントがアクセスできるファイルとして書かれている
• 小さく順序づけされたタスク に分解されている
• 期待する成果、入力、出力が明確に記載されている
• 各変更のあとに行う verification や testing のステップが明示されている

高度すぎて抽象的なプランや曖昧なプランは、確認の往復が増え、実行が止まりやすくなります。

executing-plans はテストや検証をどう扱いますか？

このスキルでは、どのテストや検証を実行するかをプラン側で指定しておくことを前提としています。各タスクに対してエージェントは次を行います。

• プランに記載されたコードや設定変更を行う
• プランに書かれた特定のテスト、チェック、コマンドを実行する
• それらの検証が成功するか、あなたと協議して整合が取れるまでは、そのタスクを completed とマークしない

これにより、テストは「後回し」ではなく、ワークフローの中核的な一部として扱われます。

すべてのタスクが終わったらどうなりますか？

すべてのタスクを実行し検証が成功したら、executing-plans は finishing-a-development-branch ワークフローに処理を引き継ぎます。

• エージェントは、仕上げ用スキルに切り替えることを宣言します
• 必須サブスキルとして superpowers:finishing-a-development-branch を使います
• そのスキルが最終チェックの実行、選択肢の提示、選ばれた仕上げアクションの実行を担います

この分離により、「実装」と「最終的な仕上げ・判断」が明確に分かれ、考えやすくなります。

もしプランが間違っていることがわかったら？

エージェントが、プランどおりに進めると誤った挙動になる、あるいはプランの内容ではそもそも成功できないと判断した場合は、次を行うべきです。

1. それ以上タスクを実行せず、いったん停止する
2. プランの どこが問題なのか を明確に説明する
3. プランを修正するのか、新しいプランを作成するのか、別のワークフローに切り替えるのかをあなたに確認する

executing-plans は、プランを「信頼すべき前提」として扱います。その前提が崩れた場合は、人間による見直しが不可欠です。

executing-plans はコード変更専用のスキルですか？

このスキルは主に、コードや関連タスクなどの 開発作業 を念頭に置いて設計されていますが、「プランを読み込む → レビューする → タスクを実行する → 検証を行う」というパターンは、要件がきちんと定義された他のプロジェクトワークフローにも適用できます。もっとも良い結果を得るには、タスクが明確で、成功条件を客観的にチェックできる領域で使うのが理想的です。

executing-plans が自分のプロジェクトに合っているかどうかは、どう評価すればよいですか？

次のような状態になっているかを指標にするとよいでしょう。

• プラン上のタスクが in_progress と completed にきちんとマークされ、履歴をたどりやすい
• エージェントが指定された検証を継続的に実行し、その結果を報告している
• プランが不明瞭だったりブロックされたりした際、早い段階で通知が来る
• finishing-a-development-branch への引き継ぎがスムーズで、毎回同じような流れで完了する

これらが満たされていれば、executing-plans はあなたのチームのプロジェクト管理・ワークフロー自動化ニーズにうまくフィットしていると考えられます。