Codex の Superpowers writing plans スキル。
Superpowers の writing-plans スキルは、仕様書を、前提知識のないエンジニアでも従えるほど詳しい実装計画にします。どのステップも小さく、テストされ、コミットされます。Jesse Vincent による Superpowers プラグインに含まれています。
2026年11月12日 更新 · 約 3 分で読めます
概要
| スキル名 | writing-plans |
| 提供元 | Jesse Vincent の Superpowers プラグイン |
| インストール | codex plugin add superpowers@openai-curated、または Codex で /plugins |
| Codex が使う場面 | 複数のステップからなるタスクの仕様書や要件があるとき。コードに手を付ける前 |
| ソース | GitHub の openai/plugins |
できること
Codex は計画を docs/superpowers/plans/ に保存します。冒頭には決まったヘッダーがあり、目的、アーキテクチャ、技術スタック、仕様書へのリンク、そして仕様書の全体的な制約を一字一句そのまま書き写します。タスクを書く前に、どのファイルを作成・変更するか、それぞれ何のためのファイルかを整理します。
そのうえで、各タスクには次の内容が並びます。
- ファイル: 作成、変更、テストするファイルの正確なパス。変更には行の範囲も付けます。
- インターフェース: 前のタスクから使うもの、あとのタスクに提供するものの、正確な名前と型。
- ステップ: テスト駆動の順番で並んだ、2〜5 分で終わる作業。失敗するテストを書く、実行する、最小限のコードを書く、もう一度実行する、コミットする。コードのステップには、実際のコードとコマンドが含まれます。
プレースホルダーは禁止です。「TBD」も「エラー処理を追加」も「タスク 3 と同様」も使いません。書き終えたら、計画を仕様書と照らし合わせて抜けや名前の食い違いを確認し、タスクごとに新しいサブエージェントで実行するか、チェックポイントを挟みながらその場で実行するかを提案します。
使いどころ
設計について合意したあと、多くの場合は brainstorming スキルのすぐあとに使います。複数のステップがあって、変更を 1 つずつ小さく、テスト済みで、レビューしやすくしたい作業や、ほかのエージェントに計画を実行させる作業に向いています。
試してみる
writing-plans スキルを使ってください。docs/superpowers/specs/ にあるチームワークスペースの仕様書をもとに、実装計画を書いてください。各タスクは、それだけでレビューできる小ささにしてください。
Claude Code でも使える?
使えます。Superpowers の README には対応エージェントとして Claude Code が載っていて、Claude の公式プラグインマーケットプレイスからインストールできます。計画のヘッダーや引き継ぎでは、計画を実行するためのほかの Superpowers のスキルを指定しているので、このフォルダをコピーするのではなく、そのプラグインを使いましょう。