using-superpowers について
using-superpowers は、関連スキルを呼び出すタイミングと方法を示すエージェント向けスキルです。応答や行動の前に適用可能なスキルを確認するよう求めます。
主な機能
- 01行動前に適用スキルを確認
- 02スキル呼び出しの要件を説明
- 03指示の優先順位を定義
- 04スキルへのアクセス方法を案内
活用シーン
- 01タスクに適用するスキルの判断
- 02エージェント作業でのスキル指示の遵守
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pcvelz/ superpowers --skill using-superpowersインストール後、Claude Code で/using-superpowersを入力して読み込まれたか確認します。
詳細
タスクにスキルが適用される場合、使用するかどうかを選ぶ余地はありません。必ず使用してください。
これは交渉の余地も、任意の選択肢もありません。理由をつけて回避することもできません。
指示の優先順位
Superpowers のスキルはデフォルトのシステムプロンプトの動作より優先されますが、ユーザーの指示は常に優先されます。
- ユーザーの明示的な指示(CLAUDE.md、直接の依頼)— 最優先
- Superpowers のスキル — デフォルトのシステム動作と競合する場合は、それに優先
- デフォルトのシステムプロンプト — 最も優先度が低い
CLAUDE.md に「TDD を使わない」とあり、スキルに「常に TDD を使う」と書かれている場合は、ユーザーの指示に従ってください。決定権はユーザーにあります。
スキルへのアクセス方法
Claude Code の場合: Skill ツールを使用してください。スキルを呼び出すと、その内容が読み込まれて提示されます。提示された内容に従ってください。スキルファイルを読むために Read ツールを使ってはいけません。
スキルの使用
ルール
返答または操作を行う前に、関連するスキルまたは指定されたスキルを呼び出してください。 スキルが適用される可能性が1%でもある場合は、適用されるかどうかを確認するために呼び出してください。呼び出したスキルが該当しないと判明した場合は、使用する必要はありません。
digraph skill_flow {
"User message received" [shape=doublecircle];
"About to EnterPlanMode? DON'T" [shape=doublecircle];
"Already brainstormed?" [shape=diamond];
"Invoke brainstorming skill" [shape=box];
"Might any skill apply?" [shape=diamond];
"Invoke Skill tool" [shape=box];
"Announce: 'Using [skill] to [purpose]'" [shape=box];
"Has checklist?" [shape=diamond];
"TaskCreate for each checklist item" [shape=box];
"Follow skill exactly" [shape=box];
"Respond (including clarifications)" [shape=doublecircle];
"About to EnterPlanMode? DON'T" -> "Already brainstormed?";
"Already brainstormed?" -> "Invoke brainstorming skill" [label="no"];
"Already brainstormed?" -> "Might any skill apply?" [label="yes"];
"Invoke brainstorming skill" -> "Might any skill apply?";
"User message received" -> "Might any skill apply?";
"Might any skill apply?" -> "Invoke Skill tool" [label="yes, even 1%"];
"Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
"Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
"Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
"Has checklist?" -> "TaskCreate for each checklist item" [label="yes"];
"Has checklist?" -> "Follow skill exactly" [label="no"];
"TaskCreate for each checklist item" -> "Follow skill exactly";
}
注意すべき兆候
次のような考えが浮かんだら、立ち止まってください。これは正当化しようとしている兆候です。
| 考え | 実際には |
|---|---|
| 「これは簡単な質問にすぎない」 | 質問もタスクです。スキルを確認してください。 |
| 「まず、もっと背景を知る必要がある」 | 確認の質問をする前にスキルを確認してください。 |
| 「まずコードベースを調べよう」 | 調べ方はスキルが示します。先にスキルを確認してください。 |
| 「Git やファイルをさっと確認できる」 | ファイルには会話の文脈がありません。スキルを確認してください。 |
| 「先に情報を集めよう」 | 情報の集め方はスキルが示します。 |
| 「正式なスキルを使うほどではない」 | スキルがあるなら使用してください。 |
| 「このスキルのことは覚えている」 | スキルは更新されています。現在の内容を読んでください。 |
| 「これはタスクに当たらない」 | 行動することはタスクです。スキルを確認してください。 |
| 「スキルを使うのは大げさだ」 | 簡単な作業が複雑になることもあります。使用してください。 |
| 「この作業だけ先にやろう」 | 何かをする前に確認してください。 |
| 「これは効率的に感じる」 | 規律のない行動は時間を浪費します。スキルはそれを防ぎます。 |
| 「意味はわかっている」 | 概念を知っていることと、スキルを使うことは別です。呼び出してください。 |
スキルの優先順位
複数のスキルが適用される可能性がある場合は、次の順に使用してください。
- プロセススキルを先に(ブレインストーミング、デバッグ)— 進め方を決めます
- 実装スキルを次に(frontend-design、mcp-builder)— 実行方法を導きます
「X を作ろう」→ まずブレインストーミング、その後に実装スキル。 「このバグを修正して」→ まずデバッグ、その後にドメイン固有のスキル。
スキルの種類
厳格型(TDD、デバッグ):厳密に従ってください。規律を損なうような適用は避けてください。
柔軟型(パターン):原則を状況に応じて適用してください。
どちらに当たるかはスキル自体が示します。
ユーザーの指示
指示は「何をするか」を示し、「どのように進めるか」は示しません。「X を追加」や「Y を修正」と言われても、ワークフローを省略してよいことにはなりません。