⚡
★ 86.6k

チャプター10：よくある質問

一般

どこから始めればいいですか？

Superpowersを初めて使う方には、以下の読み進め順をおすすめします：

  1. チャプター0：ようこそ — Superpowersとは何か、誰のためのものかを理解する
  2. チャプター1：はじめに — 環境をセットアップし、最初のスキルを実行する
  3. チャプター2：ブレインストーミング — コードを書く前にアイデアを探索する方法を学ぶ
  4. チャプター3：プラン作成 — アイデアを構造化された実装計画に変える
  5. チャプター9：鉄の法則 — すべてを機能させるコア原則

その後、ワークフローに合ったチャプターに進んでください：TDD（チャプター5）、デバッグ（チャプター6）、コードレビュー（チャプター7）、またはGit Worktrees（チャプター8）。

また、**実践ユースケース**セクションもご覧ください。ソロ機能開発からチームデバッグ、並列リファクタリングまで、Superpowersが実際のシナリオでどのように活用されるかを確認できます。

Superpowersはどのプラットフォームで動作しますか？

プラットフォームステータス
Claude Code完全サポート
Cursor完全サポート（v4.3.1以降）
Gemini CLI完全サポート（v5.0.1以降）
Codex実験的サポート（v3.3.0以降）
OpenCode完全サポート（v3.5.0以降）

通常のAIエージェントとどう違いますか？

通常のAIエージェントはプロンプトに従います。SuperpowersはAIエージェントに強制されるプロセスです。

違いは構造にあります。Superpowersなしでは、AIがコードを書き、あなたがレビューし、問題を見つけ、修正を依頼します。Superpowersを有効にすると、AIは自分でテストを書き、自分でテストを実行し、自分で検証し、失敗すると自分でデバッグします。あなたは結果を確認します。

実際的な違いは、Superpowersはより多くの機能をより少ない手直しで実現することです。AIが検証しないときにあなたが発見していたバグが、今ではAIのプロセスの一部として発見されます。

チームでSuperpowersを設定するにはどうすればいいですか？

チームセットアップには標準インストールとは別のものは何も必要ありません。各開発者が自分の環境にスキルをインストールします。スキルはロールアウトする構成ではありません—それらはAIの動作を定義するファイルです。

一貫性のために：

  1. スキルのバージョンをCLAUDE.mdに記録してください
  2. スキルのアップデートに関するレビュープロセスを確立してください
  3. チームメンバーがスキルに違反している場合（例：TDDをスキップしている場合）、それを通常のコードレビューフィードバックとして扱ってください

TDDと品質

TDDは本当に交渉の余地がありませんか？すべてのコードにテストが必要ですか？

はい。TDDは交渉の余地のない鉄の法則です—オプションのベストプラクティスではありません。

テストが難しいコードに対してよく聞かれる質問です。難しいのは本物です。しかし、Superpowersはそれを理由に例外を作りません。テストが難しい場合、それはほぼ常にコードの設計に問題があることを示しています—過度な結合、隠れた依存関係、または壊れた単一責任の原則。正しい対応はテストを書けないから免除することではなく、テストしやすくするためにコードを修正することです。

唯一の正当な例外は、テスト可能なコードがまだ存在しない場合の探索的コードです。しかし探索的コードはプロダクションコードになってはいけません。探索するなら削除するか、テストからやり直してください。

どのモデルを使うべきですか？

タスク推奨モデル
主要な実装Claude Opus 4.6
ルーティングと軽量タスクClaude Haiku 3.5
代替プラットフォームGemini 2.0 Flash、GPT-4o
コスト最適化Haiku 3.5でサブエージェント、Sonnetでオーケストレーター

重要なのは特定のモデルではなく、ツール呼び出しをサポートし、スキルの実行に必要なコンテキストウィンドウを持っていることです。

トラブルシューティング

スキルが起動しません。何が問題ですか？

スキルが期待通りに起動しない場合、このチェックリストを使用してください：

  1. スキルはインストールされていますか？ .claude/skills/ディレクトリにスキルファイルが存在することを確認してください
  2. スキルはCLAUDE.mdに文書化されていますか？ AIはCLAUDE.mdからスキルを学習します。スキルが記載されていない場合、AIはそれを認識しません
  3. コンテキストウィンドウはどのくらい埋まっていますか？ コンテキストウィンドウが高い使用率（>80%）の場合、新しいセッションを開始してください
  4. スキルを明示的に呼び出しましたか？ 一部のスキルはスラッシュコマンドで明示的な呼び出しが必要です。/skill-nameを使用して呼び出してください
  5. スキルのフォーマットは正しいですか？ スキルファイルに適切なメタデータヘッダーがあることを確認してください

問題が続く場合は、/using-superpowersを使用してスキルシステム自体をリロードしてください。

他に質問がある場合は、GitHubのissueとして提出するか、Superpowersコミュニティフォーラムで質問してください。