Claude Codeの実装計画をサブエージェントに分担してレビューする

使うとこうなる

実装計画を渡して一言頼むだけで、エージェントが司令役になり、タスクの実装とレビューを最後まで進めます。

この実装計画を、subagent-driven-developmentで最後まで進めてください。

依頼を受けたエージェントは、まず作業用のGitワークツリー（同じリポジトリを別フォルダで作業する仕組み）を用意します。続いて計画を一度読み、タスクごとのToDoを作成。着手前には計画内の矛盾を洗い出し、ファイルや受け渡しを共有するタスクの組を表にして進捗記録へ書き込みます。

その後はタスク1から順に、新しい実装担当のサブエージェント（作業を分担する別のエージェント）を呼び出します。実装担当の仕事は、実装、テスト、コミットと、結果を報告ファイルに書くところまでです。次に別のレビュー担当が差分を読み、仕様への適合とコード品質の2つについて判定を返す流れです。

すべてのタスクが終わると、ブランチ全体の変更を最も性能の高いモデルでレビューします。最後のメッセージに付くのが、エージェントが途中で自分で決めた判断の一覧「Rulings I made」です。利用者が確かめるべきものは、最終レビューの結果と判断の一覧にまとまります。

タスクの合間に「続けますか」と確認を挟むことはありません。止まって人に尋ねるのは、次の4つの場面だけです。

• 取り消せない操作や破壊的な操作
• セキュリティに関わる操作
• マージや共有ブランチへのプッシュ、公開など、ワークツリーの外に影響する操作
• 計画が壊れていて、どの進め方も当て推量になる場合

subagent-driven-developmentでできること

このスキルは「タスクごとに新しい実装担当」「タスクごとのレビュー」「最後の全体レビュー」の3つを組み合わせて、計画どおりの実装を支えます。配布元はGitHubのobra/superpowersです。同じリポジトリには、計画づくりやレビュー依頼のスキルも並んでいます。

タスクごとに新しいエージェントへ任せる

各タスクは、前の会話の経緯を引き継がない新しいサブエージェントが実装します。司令役はタスクの全文を切り出した指示ファイルを渡し、計画ファイル全体は読ませません。前のタスクの要約を積み重ねて渡すこともないので、実装担当は自分のタスクだけに集中できます。

同じ種類の小さな修正が複数並ぶ場合は、まとめて1つのサブエージェントに渡します。一方で、実装担当を複数同時に動かすことはしません。変更どうしの衝突を避けるためです。

同じリポジトリのexecuting-plansとの違いは次のとおりです。

項目	subagent-driven-development	executing-plans
実装の担い手	タスクごとに新しいサブエージェント	1つの文脈ですべてのタスク
レビューの時期	各タスクの後と、最後の全体レビュー	最後のレビューのみ
文脈のコスト	タスクとレビューのたびに新しい文脈	1つの文脈と最終レビュー1回
共通点	同じセッションで動き、同じ進捗記録を使い、タスク間で止まらない	同左

仕様と品質をタスクごとに確かめる

各タスクでは、レビュー担当が仕様への適合と品質の両方を確かめます。レビュー担当に渡されるのは、指示ファイル、実装担当の報告ファイル、コミット一覧と差分をまとめたファイルです。どちらかの判定が欠けた報告は受け付けません。実装担当の自己レビューがあっても、このレビューは省略されません。

重要な指摘が出ると、修正のやり直しに入ります。やり直しは1タスクにつき5回までです。

1. 1〜3回目は、最初の実装担当に指摘をそのまま渡して直させる
2. 4〜5回目は、より性能の高いモデルで新しい実装担当を立てる
3. 毎回、修正部分だけを対象にした再レビューを行う
4. 5回で解消しない指摘は、司令役が判断して記録に残す

軽微な指摘はやり直しに入れず、進捗記録に保留として書き留めます。保留の一覧は最終レビューに渡され、マージ前に直すべきものがそこで選び分けられます。

進捗をファイルに残して再開する

進捗は記録ファイルに残るので、中断しても完了済みのタスクを飛ばして再開できます。記録ファイルの置き場所はリポジトリ内の.superpowers/sdd/配下で、計画ごとに作られる仕組みです。このフォルダはGitの管理対象外。完了したタスクには完了の行が付きます。

会話の記憶は、圧縮（コンパクション）で失われることがあります。そのため再開時は、自分の記憶より記録ファイルとgit logを信頼する手順です。完了済みのタスクを丸ごとやり直す失敗は、この仕組みで防げます。

モデルを役割で使い分ける

モデルは、役割ごとに処理できる最小限の性能のものを選びます。呼び出すたびにモデルを明示する決まりがあり、指定を省いたまま高価なモデルを使い続けることはありません。

役割	選ぶモデル
1〜2ファイルで仕様が明確な実装	速くて安いモデル
複数ファイルにまたがる統合や不具合調査	標準のモデル
設計判断と最後の全体レビュー	最も性能の高いモデル

完了前にブランチ全体をレビューする

最後のレビューでは、ブランチの開始点から現在までの差分をまとめて読ませます。指摘が出た場合は、すべての指摘を1つの修正担当にまとめて渡し、再レビューは1回だけです。その後は作業用フォルダを削除し、finishing-a-development-branchに引き継いでマージやPull Requestの選択へ進みます。

インストール方法

インストールには、コマンド1行で入れる方法と、Claudeに確認を任せて入れる方法があります。コマンドで入れる場合は、次を実行してください。

npx skills add https://github.com/obra/superpowers --skill subagent-driven-development

Claudeに頼む場合は、次の文面をそのまま送ってください。

次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/subagent-driven-development

まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、~/.claude/skills/subagent-driven-development/ に配置してください。

置き場所は、すべてのプロジェクトで使うなら~/.claude/skills/、特定のプロジェクトだけで使うならそのプロジェクトの.claude/skills/です。配布元のファイル構成はGitHubのSKILL.mdで確かめられます。

スキルに含まれるのは、実装担当・タスクレビュー・再レビュー用の指示テンプレートと、作業用フォルダや差分ファイルを作る3つのスクリプトです。

使い方の例

依頼文は、計画ファイルの場所と何をしてほしいかを短く伝えるだけで足ります。

docs/plan.mdの実装計画を、タスクごとに別のエージェントへ任せて進めてください。

ワークツリーを確認したあと、計画内の矛盾を調べた表が進捗記録に書かれます。続いてタスク1から実装とレビューが順に進み、最後に全体レビューの結果と判断の一覧が返ってきます。

前回の作業が途中で止まりました。進捗記録を確認して、未完了のタスクから再開してください。

この場合は、記録ファイルで完了済みのタスクを確かめ、最初の未完了タスクから再開します。修正のやり直し中に止まっていたタスクは、その次の回から続ける手順です。

各タスクで仕様と品質を確認し、最後にブランチ全体の変更をレビューしてください。

タスクごとのレビューに加えて、ブランチの開始点からの差分を最も性能の高いモデルがレビューします。保留にしていた軽微な指摘を直すかどうかも、このレビューで判断されます。

注意点

このスキルを使うには、実装計画と、サブエージェントを呼び出せる環境の2つが必要です。計画がない場合やタスク同士が密に結びついている場合は、手作業で進めるか、先に計画を練る段階に戻るよう案内されます。サブエージェントを使えない環境では、executing-plansが代わりの選択肢になります。

作業の場は、Gitの分離された作業領域です。main/masterブランチで実装を始める場合は、利用者の明示的な同意を求めます。付属スクリプトはbashで動作。作業用フォルダはGit管理外なので、git clean -fdxを実行すると消えてしまう点に注意が必要です。

途中の判断は、4つの停止条件を除いてエージェントが自分で下します。判断の一覧は必ず読み、意図と違うものがあれば手直しを指示してください。 また、タスクとレビューのたびに新しい文脈を使うため、1つの会話で進めるより文脈のコストは増えます。

最終レビューで参照するのは、同じリポジトリのrequesting-code-reviewに含まれるレビュー用テンプレートです。単体で入れる場合は、このスキルもあわせて入れておくと手順どおりに動きます。

ライセンスはMITです。入れる前にSKILL.mdと付属スクリプトの中身を読み、処理内容を確かめてください。

関連スキル

同じobra/superpowersのスキルのうち、このスキルの前後で使うものを3つ紹介します。

executing-plansは、作成済みの実装計画を同じセッションでタスクごとに実行します。サブエージェントを使えない環境や、1つの文脈で進めたい場合の選択肢です。

requesting-code-reviewは、別のエージェントにコードレビューを依頼するスキルです。subagent-driven-developmentの最終レビューは、このスキルのテンプレートを使います。

finishing-a-development-branchは、実装完了後にテストを確認し、マージやPull Request作成を選んで進めます。subagent-driven-developmentの最後に引き継がれるスキルです。

まとめ

subagent-driven-developmentは、実装計画をタスクごとに新しいサブエージェントへ任せ、各タスクのレビューと最後の全体レビューを挟みながら進めるスキルです。進捗は記録ファイルに残るため、長い作業でも続きから再開できます。計画とタスクの切り分けができていて、仕様からのずれを早めに見つけたい開発に向いています。インストールの前後には、cccskillsのページで配布元と関連スキルを確かめてください。