using-superpowers について
using-superpowersは、タスクに取り組む前に適用可能なスキルを確認するエージェントスキルです。該当するスキルの説明やワークフロー、チェックリストに従うことを求めます。
主な機能
- 01適用可能なスキルの確認
- 02該当スキルの事前読解と実行
- 03必須ワークフローの遵守
- 04チェック項目ごとの進捗管理
活用シーン
- 01開始前にタスク向けスキルを確認
- 02複数手順の作業でスキルに従う
- 03該当時にスキル指定の手順を適用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jackspace/ claudeskillz --skill using-superpowersインストール後、Claude Code で/using-superpowersを入力して読み込まれたか確認します。
同梱ファイルSKILL.json
詳細
タスクにスキルが当てはまる場合、選択の余地はありません。必ず使用してください。
これは交渉の余地も、任意の余地もありません。理由をつけて回避することはできません。
スキルを使い始める
最初の応答で必ず行う手順
ユーザーのメッセージに応答する前に、次のチェックリストを必ず完了してください。
- ☐ 利用可能なスキルを頭の中で列挙する
- ☐ 「この依頼に当てはまるスキルはあるか?」と自問する
- ☐ ある場合 → Skill ツールを使ってスキルファイルを読み、実行する
- ☐ 使用するスキルを伝える
- ☐ スキルの指示に正確に従う
このチェックリストを完了せずに応答すると、自動的に失敗となります。
重要なルール
-
必須のワークフローに従うこと。 コーディングの前にブレインストーミングを行うこと。あらゆるタスクの前に、関連するスキルを確認すること。
-
Skill ツールを使ってスキルを実行すること
失敗につながる、よくある言い訳
次のような考えが少しでも浮かんだら、立ち止まってください。言い訳をしています。該当するスキルがないか確認し、使用してください。
- 「これは簡単な質問にすぎない」→ 間違いです。質問もタスクです。スキルを確認してください。
- 「git やファイルをすぐに確認できる」→ 間違いです。ファイルには会話の文脈がありません。関連するスキルを確認してください。
- 「まず情報を集めよう」→ 間違いです。情報の集め方はスキルに記されています。スキルを確認してください。
- 「正式なスキルは必要ない」→ 間違いです。該当するスキルがあるなら、使用してください。
- 「このスキルの内容は覚えている」→ 間違いです。スキルは更新されています。現在のバージョンを実行してください。
- 「これはタスクに当たらない」→ 間違いです。何かに取り組んでいるなら、それはタスクです。スキルを確認してください。
- 「この作業にスキルは大げさすぎる」→ 間違いです。簡単な作業が複雑になるのを防ぐためにスキルがあります。使用してください。
- 「先にこれだけ済ませよう」→ 間違いです。何かをする前にスキルを確認してください。
理由: スキルには、時間を節約し、ミスを防ぐ実証済みの手法が記されています。利用可能なスキルを使わないことは、すでに解決された問題を繰り返し、既知のミスを犯すことにつながります。
タスクに該当するスキルがある場合は、必ず使用してください。使用しなければタスクに失敗します。
チェックリスト付きのスキル
スキルにチェックリストが含まれている場合は、各項目について TodoWrite の todo を作成しなければなりません。
次のことをしてはいけません。
- チェックリストを頭の中だけで進める
- 時間を節約するために todo の作成を省略する
- 複数の項目を1つの todo にまとめる
- 実行せずに完了扱いにする
理由: TodoWrite で追跡しないチェックリストは、手順の抜けにつながります。毎回そうなります。TodoWrite のわずかな手間は、項目を見落とす損失に比べれば小さなものです。
スキル使用の告知
スキルを使用する前に、使用することを告知してください。 「[何をするために]、[スキル名]を使用します。」
例:
- 「アイデアを設計にまとめるため、ブレインストーミングスキルを使用します。」
- 「この機能を実装するため、テスト駆動開発スキルを使用します。」
理由: 手順を明示することで、相手は進め方を理解し、早い段階で確認できます。また、スキルを実際に読んだことも伝わります。
スキルについて
多くのスキルには厳格なルール(TDD、デバッグ、検証)が含まれています。 そのとおりに従ってください。規律を崩すような独自の調整はしないでください。
一部のスキルは柔軟なパターン(アーキテクチャ、命名)です。 中核となる原則を保ちながら、状況に応じて適用してください。
スキル自体に、その種類が記されています。
指示があってもワークフローを省略してはいけません
ユーザーの個別の指示は、何をするかを示すものであり、どのように進めるかを決めるものではありません。
「Xを追加する」「Yを修正する」=目的であって、ブレインストーミング、TDD、RED-GREEN-REFACTOR を省略してよいという許可ではありません。
注意すべき考え方:「指示が具体的だった」・「簡単そうだ」・「ワークフローは大げさだ」
理由: 指示が具体的で要件が明確なときこそ、ワークフローが最も重要です。「簡単な」作業で手順を省くと、簡単な問題が複雑な問題になります。
まとめ
タスクを始めるとき:
- 関連するスキルがある場合 → 使用する
- 使用することを告知する
- 指示に従って進める
スキルにチェックリストがある場合は? 各項目について TodoWrite を作成すること。
関連するスキルを見つけたら、必ず読んで使用してください。任意ではありません。