Writing Plans Skill

Writing Plans は Superpowers のスキルです（スキルのソース）。複数ステップの作業について仕様や明確な要件があり、まだコードに触れていない段階で動き、README の言葉で言えば「熱意はあるがセンスと判断力がなく、プロジェクトを知らず、テストが嫌いな新人エンジニア」でも従える実装計画を作ります。

通常は Brainstorming の後に続き、実行系のスキルへ引き継ぎます。

主な機能

• 計画の保存：docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md。希望があれば別の場所にも。
• 標準ヘッダー：目標、アーキテクチャ、技術スタック、実装する仕様、全体の制約、レビューの焦点。
• まずファイルの地図：作成・変更するファイルとそれぞれの責務を決め、小さく焦点の絞れたファイルを好む。
• 細かなステップ：各ステップは 2 から 5 分の一動作（失敗するテストを書く、実行、実装、再実行、コミット）で、テスト可能な成果物で終わるタスクにまとめる。
• プレースホルダー禁止：「未定」「適切なエラー処理を追加」「上記のテストを書く」「タスク N と同様」は計画の失敗。コードのステップには実際のコードブロックが必要。
• 自己レビュー：仕様の網羅、プレースホルダーの検索、タスク間で名前やシグネチャが一貫しているかを確認。
• 引き継ぎ：あなたが計画を確認し、サブエージェント駆動かインライン実行かを選ぶ。

使用シナリオ

• 一つのプロンプトに収まらない機能。
• 別のエージェントや安価なモデルが実行する計画。
• コンテキストの圧縮や新しいセッションをまたいで続ける作業。

料金

MIT ライセンスの無料オープンソースです。Superpowers を開発する Prime Radiant は企業向けに商用サポートを提供しています。実質的なコストはトークンで、プロセス系スキルは質問、レビュー、サブエージェントの実行を増やします。

はじめに

Superpowers は一つのプラグインとしてインストールされ、このスキルはライブラリ全体（v6.4.1 で 15 スキル）と一緒に入ります。Claude Code では /plugin install superpowers@claude-plugins-official。Cursor は /add-plugin superpowers、Gemini CLI は gemini extensions install https://github.com/obra/superpowers。Codex、GitHub Copilot CLI、OpenCode、Pi などのコマンドは README にあります。スキルは自動で起動し、名前を指定して呼び出すこともできます。 仕様が承認されると、エージェントが計画を書き、確認用にリンクを示します。

制約：詳細な計画は書くのに時間とトークンがかかり、計画の質は元の仕様次第です。ごく小さな変更ならチャットでの短い設計のほうが向いています。

よくある質問

なぜそこまで細かく書くのですか？

計画で決められた判断を実行時に残さないためで、安価なモデルや新しいサブエージェントでも作業できるようになります。

誰が実行しますか？

Subagent-Driven Development か Executing Plans を選べます。

代替案

• Planning with Files：Manus 流の永続的な markdown 計画。
• Spec Kit：計画とタスクの段階を持つ GitHub の仕様駆動ツールキット。
• Unlazy：大きな作業に受け入れゲートを設ける。

まとめ

合意した設計と、エージェントが推測せずに作れるコードをつなぐ橋です。詳しくは skills カテゴリ へ。