mcpField
U
using-superpowers

using-superpowers

github.com/jackspaceエージェントワークフロー1639 回インストール12 週間前に更新
リポジトリ

using-superpowers について

using-superpowersは、タスクに取り組む前に適用可能なスキルを確認するエージェントスキルです。該当するスキルの説明やワークフロー、チェックリストに従うことを求めます。

主な機能

  1. 01適用可能なスキルの確認
  2. 02該当スキルの事前読解と実行
  3. 03必須ワークフローの遵守
  4. 04チェック項目ごとの進捗管理

活用シーン

  1. 01開始前にタスク向けスキルを確認
  2. 02複数手順の作業でスキルに従う
  3. 03該当時にスキル指定の手順を適用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jackspace/claudeskillz --skill using-superpowers

インストール後、Claude Code で/using-superpowersを入力して読み込まれたか確認します。

同梱ファイルSKILL.json

詳細

自分が行おうとしていることにスキルが当てはまる可能性が1%でもあると思ったら、そのスキルを必ず読まなければなりません。

タスクにスキルが当てはまる場合、選択の余地はありません。必ず使用してください。

これは交渉の余地も、任意の余地もありません。理由をつけて回避することはできません。

スキルを使い始める

最初の応答で必ず行う手順

ユーザーのメッセージに応答する前に、次のチェックリストを必ず完了してください。

  1. ☐ 利用可能なスキルを頭の中で列挙する
  2. ☐ 「この依頼に当てはまるスキルはあるか?」と自問する
  3. ☐ ある場合 → Skill ツールを使ってスキルファイルを読み、実行する
  4. ☐ 使用するスキルを伝える
  5. ☐ スキルの指示に正確に従う

このチェックリストを完了せずに応答すると、自動的に失敗となります。

重要なルール

  1. 必須のワークフローに従うこと。 コーディングの前にブレインストーミングを行うこと。あらゆるタスクの前に、関連するスキルを確認すること。

  2. Skill ツールを使ってスキルを実行すること

失敗につながる、よくある言い訳

次のような考えが少しでも浮かんだら、立ち止まってください。言い訳をしています。該当するスキルがないか確認し、使用してください。

  • 「これは簡単な質問にすぎない」→ 間違いです。質問もタスクです。スキルを確認してください。
  • 「git やファイルをすぐに確認できる」→ 間違いです。ファイルには会話の文脈がありません。関連するスキルを確認してください。
  • 「まず情報を集めよう」→ 間違いです。情報の集め方はスキルに記されています。スキルを確認してください。
  • 「正式なスキルは必要ない」→ 間違いです。該当するスキルがあるなら、使用してください。
  • 「このスキルの内容は覚えている」→ 間違いです。スキルは更新されています。現在のバージョンを実行してください。
  • 「これはタスクに当たらない」→ 間違いです。何かに取り組んでいるなら、それはタスクです。スキルを確認してください。
  • 「この作業にスキルは大げさすぎる」→ 間違いです。簡単な作業が複雑になるのを防ぐためにスキルがあります。使用してください。
  • 「先にこれだけ済ませよう」→ 間違いです。何かをする前にスキルを確認してください。

理由: スキルには、時間を節約し、ミスを防ぐ実証済みの手法が記されています。利用可能なスキルを使わないことは、すでに解決された問題を繰り返し、既知のミスを犯すことにつながります。

タスクに該当するスキルがある場合は、必ず使用してください。使用しなければタスクに失敗します。

チェックリスト付きのスキル

スキルにチェックリストが含まれている場合は、各項目について TodoWrite の todo を作成しなければなりません。

次のことをしてはいけません。

  • チェックリストを頭の中だけで進める
  • 時間を節約するために todo の作成を省略する
  • 複数の項目を1つの todo にまとめる
  • 実行せずに完了扱いにする

理由: TodoWrite で追跡しないチェックリストは、手順の抜けにつながります。毎回そうなります。TodoWrite のわずかな手間は、項目を見落とす損失に比べれば小さなものです。

スキル使用の告知

スキルを使用する前に、使用することを告知してください。 「[何をするために]、[スキル名]を使用します。」

例:

  • 「アイデアを設計にまとめるため、ブレインストーミングスキルを使用します。」
  • 「この機能を実装するため、テスト駆動開発スキルを使用します。」

理由: 手順を明示することで、相手は進め方を理解し、早い段階で確認できます。また、スキルを実際に読んだことも伝わります。

スキルについて

多くのスキルには厳格なルール(TDD、デバッグ、検証)が含まれています。 そのとおりに従ってください。規律を崩すような独自の調整はしないでください。

一部のスキルは柔軟なパターン(アーキテクチャ、命名)です。 中核となる原則を保ちながら、状況に応じて適用してください。

スキル自体に、その種類が記されています。

指示があってもワークフローを省略してはいけません

ユーザーの個別の指示は、何をするかを示すものであり、どのように進めるかを決めるものではありません。

「Xを追加する」「Yを修正する」=目的であって、ブレインストーミング、TDD、RED-GREEN-REFACTOR を省略してよいという許可ではありません。

注意すべき考え方:「指示が具体的だった」・「簡単そうだ」・「ワークフローは大げさだ」

理由: 指示が具体的で要件が明確なときこそ、ワークフローが最も重要です。「簡単な」作業で手順を省くと、簡単な問題が複雑な問題になります。

まとめ

タスクを始めるとき:

  1. 関連するスキルがある場合 → 使用する
  2. 使用することを告知する
  3. 指示に従って進める

スキルにチェックリストがある場合は? 各項目について TodoWrite を作成すること。

関連するスキルを見つけたら、必ず読んで使用してください。任意ではありません。

コメント