using-superpowers

特定のタスクを実行するためにサブエージェントとして派遣された場合は、このスキルをスキップしてください。 自分のタスクにスキルが当てはまる可能性が少しでも（1％でも）あると思う場合は、必ずそのスキルを呼び出してください。

タスクにスキルが当てはまる場合、それを使わないという選択肢はありません。必ず使ってください。

これは交渉の余地も、任意の選択肢もありません。自分に都合のよい理由をつけて回避することはできません。

指示の優先順位

Superpowers Ruby スキルはデフォルトのシステムプロンプトの動作より優先されますが、ユーザーの指示は常に優先されます。

1. ユーザーの明示的な指示（CLAUDE.md、GEMINI.md、AGENTS.md、直接の依頼）— 最優先
2. Superpowers スキル — 競合する場合、デフォルトの動作を上書きします
3. デフォルトのシステムプロンプト — 最も優先度が低い

CLAUDE.md、GEMINI.md、または AGENTS.md に「TDD を使わない」と書かれていて、スキルに「常に TDD を使う」と書かれている場合は、ユーザーの指示に従ってください。決定権はユーザーにあります。

スキルへのアクセス方法

Claude Code の場合： Skill ツールを使います。スキルを呼び出すと、その内容が読み込まれて表示されるので、その指示に従ってください。スキルファイルを読むために Read ツールを使ってはいけません。

Copilot CLI の場合： skill ツールを使います。スキルはインストール済みのプラグインから自動検出されます。skill ツールは Claude Code の場合と同様に動作します。

Gemini CLI の場合： スキルは activate_skill ツールで有効化します。Gemini はセッション開始時にスキルのメタデータを読み込み、必要に応じて全内容を有効化します。

その他の環境の場合： スキルの読み込み方法について、使用しているプラットフォームのドキュメントを確認してください。

スキルの使用方法

ルール

返答や操作を行う前に、関連するスキル、または依頼されたスキルを必ず呼び出してください。 スキルが当てはまる可能性が少しでもあれば、確認のために呼び出す必要があります。呼び出したスキルが状況に合わないとわかった場合は、使う必要はありません。

digraph skill_flow {
    "User message received" [shape=doublecircle];
    "About to EnterPlanMode?" [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];
    "Create TodoWrite todo per item" [shape=box];
    "Follow skill exactly" [shape=box];
    "Respond (including clarifications)" [shape=doublecircle];

    "About to EnterPlanMode?" -> "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?" -> "Create TodoWrite todo per item" [label="yes"];
    "Has checklist?" -> "Follow skill exactly" [label="no"];
    "Create TodoWrite todo per item" -> "Follow skill exactly";
}

危険信号

次のように考えたら、立ち止まってください。これは都合のよい理由をつけて回避しようとしている兆候です。

考え	実際
「これは簡単な質問にすぎない」	質問もタスクです。スキルを確認してください。
「まずは追加の情報が必要だ」	確認の質問をする前に、スキルを確認してください。
「先にコードベースを調べよう」	スキルは調査の方法も教えてくれます。まず確認してください。
「Git やファイルをすぐに確認できる」	ファイルから会話の背景はわかりません。スキルを確認してください。
「先に情報を集めよう」	スキルは情報の集め方も教えてくれます。
「正式なスキルは必要ない」	スキルがあるなら使ってください。
「このスキルのことは覚えている」	スキルは更新されることがあります。最新版を確認してください。
「これはタスクではない」	行動はタスクです。スキルを確認してください。
「このスキルは大げさすぎる」	簡単なことでも複雑になる場合があります。使ってください。
「まずこれだけやってしまおう」	何かをする前に確認してください。
「これは生産的に思える」	規律のない行動は時間を無駄にします。スキルはそれを防ぎます。
「意味はわかっている」	概念を知っていることと、スキルを使うことは別です。呼び出してください。

スキルの優先順位

複数のスキルが該当する場合は、次の順序で使ってください。

1. プロセススキルを最初に（ブレインストーミング、デバッグ）— 進め方を決めます
2. 実装スキルを次に（フロントエンドデザイン、MCP ビルダー）— 実行方法をガイドします

「X を作ろう」→ まずブレインストーミングを行い、次に実装スキルを使います。 「このバグを修正して」→ まずデバッグを行い、次に領域固有のスキルを使います。

スキルの種類

厳格型（TDD、デバッグ）：厳密に従ってください。規律を緩めてはいけません。

柔軟型（パターン）：原則を状況に合わせて適用してください。

スキル自体にどちらの種類かが示されています。

ユーザーの指示

指示は「何をするか」を定めるものであり、「どのようにするか」を定めるものではありません。「X を追加して」や「Y を修正して」と言われても、ワークフローを省略してよいという意味ではありません。

スキルカタログ

利用可能なすべてのスキル — name の値を使って Skill ツールで呼び出してください。

プロセスとワークフロー

名前	使用するタイミング
superpowers-ruby:brainstorming	創造的な作業を始めるとき — 新機能、コンポーネント、動作の変更など（必須）
superpowers-ruby:test-driven-development	機能やバグ修正を実装するとき — 実装コードを書く前（必須）
superpowers-ruby:systematic-debugging	バグや予期しない動作を診断するとき
superpowers-ruby:writing-plans	複数ステップにわたる実装を計画するとき
superpowers-ruby:executing-plans	既存の計画を実行するとき
superpowers-ruby:dispatching-parallel-agents	サブエージェント間で独立した作業を並列化するとき
superpowers-ruby:subagent-driven-development	サブエージェントを使ってコードを実装・レビューするとき
superpowers-ruby:verification-before-completion	タスクを終えるとき — 完了とする前
superpowers-ruby:finishing-a-development-branch	PR に向けて機能ブランチを仕上げるとき
superpowers-ruby:using-git-worktrees	並列作業用に分離された git worktree が必要なとき
superpowers-ruby:compound	重要な問題を解決した直後 — 解決策を記録するとき

セッションの継続

名前	使用するタイミング
superpowers-ruby:handoff	コンテキストを切り替える前、セッションを終了するとき、または進捗を手動で保存するときに、セッションの状態を記録するとき
superpowers-ruby:handoff-resume	新しいセッションを開始し、以前の引き継ぎ内容をもとに続けるとき
superpowers-ruby:handoff-list	利用可能な引き継ぎドキュメントを確認するとき

Ruby と Rails

名前	使用するタイミング
superpowers-ruby:ruby	純粋な Ruby のコードを書く、レビューする、またはデバッグするとき — 慣用的なパターン、Ruby 3.x 以降の機能（パターンマッチング、Data.define、エンドレスメソッド）、メモ化、結果オブジェクト
superpowers-ruby:rails-guides	Rails 固有のトピックに取り組むとき：ActiveRecord、ルーティング、コントローラー、ビュー、メーラー、ジョブ、Action Cable、Action Text、Active Storage、マイグレーション、バリデーション、関連付け、キャッシュ、セキュリティ
superpowers-ruby:37signals-style	37signals/Basecamp スタイルで Rails コードを書くとき — コントローラー、モデル、ビュー、Hotwire、テスト、データベース、設計思想
superpowers-ruby:ruby-commit-message	Ruby または Rails プロジェクトで変更をコミットするとき — 開発者にとって読みやすい本文を含む Conventional Commits 形式
superpowers-ruby:sandi-metz-rules	品質向上のために Ruby コードをレビューまたはリファクタリングするとき — クラスは 100 行未満、メソッドは 5 行未満、引数は最大 4 つ、コントローラーの各アクションで扱うオブジェクトは 1 つ

Hotwire と Stimulus

名前	使用するタイミング
superpowers-ruby:hwc-stimulus-fundamentals	Stimulus コントローラーのライフサイクル、値、ターゲット、アウトレット、アクションパラメーター、キーボードイベントを扱うとき — フレームワークレベルの API
superpowers-ruby:hwc-navigation-content	Turbo Drive/Frames のナビゲーションを実装するとき：ページネーション、タブ付きナビゲーション、遅延読み込み、ファセットフィルタリング、キャッシュのライフサイクル、スクロール位置の復元
superpowers-ruby:hwc-forms-validation	Hotwire のフォームワークフローを構築するとき：送信のライフサイクル、インライン編集、バリデーションエラー、入力補完、モーダルフォーム
superpowers-ruby:hwc-ux-feedback	複数の機能にまたがる UX フィードバックを追加するとき：読み込み状態、ビジーインジケーター、進行状況バー、楽観的 UI、ページ遷移
superpowers-ruby:hwc-realtime-streaming	プッシュ型の Hotwire 機能を実装するとき：WebSocket/SSE 経由の Turbo Streams、カスタムストリームアクション、リストのリアルタイム更新、タブ間同期
superpowers-ruby:hwc-media-content	メディアを多用する機能を構築するとき：画像・動画・音声のアップロード、プレビュー、再生コントロール、進行状況の追跡、サードパーティ製メディアライブラリ

セキュリティ

名前	使用するタイミング
superpowers-ruby:brakeman	Rails のセキュリティ監査を実施するとき、SQL インジェクション/XSS/コマンドインジェクションについてコードを分析するとき、または CI/CD のセキュリティスキャンを設定するとき

コードレビューと品質

名前	使用するタイミング
superpowers-ruby:requesting-code-review	コードレビューを依頼するとき
superpowers-ruby:receiving-code-review	受け取ったコードレビューのフィードバックに対応するとき

メタ

名前	使用するタイミング
superpowers-ruby:writing-skills	新しいスキルを作成するとき、または既存のスキルを改善するとき
superpowers-ruby:compound	重要な解決策を複合的な知識として記録するとき
superpowers-ruby:compound-refresh	リファクタリング、移行、依存関係のアップグレード後など、docs/solutions/ の学びが古くなっている可能性があるとき