using-superpowers について
using-superpowers は、AI エージェントがあらゆる操作の前に該当するスキルを確認し、呼び出すよう指示するエージェントスキルです。Superpowers のスキル体系で動作するエージェント向けで、スキルの優先順位とプラットフォーム別の参照ファイルについて説明しています。
主な機能
- 01操作前のスキル確認ルール
- 02スキルの優先順位
- 03よくある言い訳の対照表
- 04プラットフォーム別の参照ファイル
活用シーン
- 01コーディング作業の前に適切なプロセススキルを選ばせる
- 02複数のエージェント環境でスキル呼び出しを統一する
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ obra/ superpowers --skill using-superpowersインストール後、Claude Code で/using-superpowersを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/antigravity-tools.mdclaude-code-tools.mdcodex-tools.mdgemini-tools.mdhermes-tools.mdmuse-tools.mdpi-tools.md詳細
スキルがタスクに適用される場合、使わないという選択肢はありません。必ず使ってください。
これは交渉の余地がありません。使わない理由を正当化することはできません。
ルール
回答や操作を行う前に、関連するスキルまたは指定されたスキルを呼び出してください。確認の質問、コードベースの調査、ファイルの確認も含まれます。スキルが状況に合わないと判明した場合は、使わなくてもかまいません。
プランモードに入る前に: まだブレインストーミングを行っていない場合は、まずブレインストーミングのスキルを呼び出してください。
その後、「[スキル名]を使って[目的]を行います」と伝え、スキルの指示に正確に従ってください。チェックリストがある場合は、項目ごとにToDoを作成してください。
スキルの優先順位
複数のスキルが適用される場合は、まずプロセススキルを実行してください。プロセススキルが進め方を定め、その後に実装スキル(frontend-designなど)を実行します。ブレインストーミングと体系的デバッグは、Superpowersで最もよく使われるプロセススキルですが、ほかのスキルにも同じルールが適用されます。
- 「Xを作ろう」→ まずsuperpowers:brainstormingを実行し、その後に実装スキルを実行します。
- 「このバグを修正して」→ まずsuperpowers:systematic-debuggingを実行し、その後にドメインスキルを実行します。
注意すべき兆候
次のように考えたら、立ち止まってください。これは理由をつけて回避しようとしている兆候です。
| 考え | 実際 |
|---|---|
| 「これは簡単な質問にすぎない」 | 質問もタスクです。スキルを確認してください。 |
| 「まず詳しい情報が必要だ」 | 追加の質問をする前にスキルを確認してください。 |
| 「まずコードベースを調べよう」 | スキルは調査の方法を示します。先に確認してください。 |
| 「gitやファイルをすぐ確認できる」 | ファイルから会話の文脈はわかりません。スキルを確認してください。 |
| 「まず情報を集めよう」 | スキルは情報収集の方法を示します。 |
| 「正式なスキルは必要ない」 | スキルがあるなら、使ってください。 |
| 「このスキルのことは覚えている」 | スキルは更新されます。現在の内容を読んでください。 |
| 「これはタスクではない」 | 操作はタスクです。スキルを確認してください。 |
| 「スキルは大げさすぎる」 | 簡単なことが複雑になる場合があります。使ってください。 |
| 「まずこれだけやろう」 | 何かをする前に確認してください。 |
| 「これが生産的に思える」 | 規律のない作業は時間を無駄にします。スキルを使えば防げます。 |
| 「意味はわかっている」 | 概念を知っていることと、スキルを使うことは別です。 |
プラットフォームへの適応
使用環境が以下に該当する場合は、特別な指示について対応するリファレンスファイルを読んでください。
- Claude Code:
references/claude-code-tools.md - Codex:
references/codex-tools.md - Pi:
references/pi-tools.md - Antigravity:
references/antigravity-tools.md - Hermes Agent:
references/hermes-tools.md - Muse:
references/muse-tools.md
ユーザーの指示
ユーザーの指示(CLAUDE.md、AGENTS.md、GEMINI.mdなど、および直接の依頼)はスキルより優先され、スキルはデフォルトの動作より優先されます。人間のパートナーから明示的に指示された場合に限り、スキルの手順や指示を省略してください。