NomenAK/SuperClaude View GitHub Homepage for Latest Official Releases

AIを活用したブラウザ自動化フレームワーク。自然言語とコードを組み合わせてブラウザを制御します。

MITPythonSuperClaudeNomenAK 8.5k Last Updated: July 17, 2025

SuperClaude - プロフェッショナルAI開発フレームワーク

プロジェクト概要

SuperClaudeは、Claude Codeの機能を強化するために特別に設計された、包括的な設定フレームワークです。これにより、Claude Codeは汎用AIアシスタントから、19の専門化コマンド、9つの認知役割、および高度な開発方法論を提供する専門化されたAI開発パートナーへと変貌します。

コア特性

🎯 認知役割システム

SuperClaudeは、それぞれ特定の専門分野と思考パターンを持つ9つの専門化された認知役割を提供します。

役割 専門分野 使用シナリオ コマンド例
architect システム設計、長期保守性 大規模システムの計画 /persona:architect → /user:design --api --ddd
frontend ユーザーエクスペリエンス、視覚インターフェース UI/UX作業 /persona:frontend → /user:build --react
backend パフォーマンス、信頼性、API サーバーサイド開発 /persona:backend → /user:build --api
analyzer 根本原因分析、根拠に基づいた意思決定 複雑な問題のデバッグ /persona:analyzer → /user:troubleshoot --investigate
security 脅威モデリング、セキュリティ優先 セキュリティレビュー /persona:security → /user:scan --security
mentor 教育、誘導的発見 学習/説明 /persona:mentor → /user:explain --depth
refactorer コード品質、簡素化 コード改善 /persona:refactorer → /user:improve --quality
performance 速度最適化、ボトルネック分析 パフォーマンスチューニング /persona:performance → /user:improve --performance
qa 品質保証、テスト テストワークフロー /persona:qa → /user:test --coverage

🛠️ 専門化コマンドシステム

SuperClaudeは、開発ライフサイクル全体をカバーする18の専門化されたスラッシュコマンドを提供します。

開発コマンド（3個）

  • /user:build - 汎用プロジェクトビルダー
    • --init 新規プロジェクト、--feature 機能追加、--react Reactアプリケーション、--api バックエンド、--tdd テスト駆動
  • /user:dev-setup - 開発環境設定
    • --install ツール、--ci CI/CD、--monitor 監視
  • /user:test - テストフレームワーク
    • --coverage カバレッジ、--watch ウォッチモード、--e2e エンドツーエンドテスト

分析と改善コマンド（4個）

  • /user:analyze - 多次元分析
    • --code コードレビュー、--architecture 設計、--profile パフォーマンス、--security 脆弱性
  • /user:troubleshoot - デバッグと修正
    • --investigate 調査、--fix 修正、--five-whys 根本原因、--prod 本番環境
  • /user:improve - コード/パフォーマンスの強化
    • --quality リファクタリング、--performance 最適化、--iterate 継続的改善、--threshold 目標パーセンテージ
  • /user:explain - 詳細な説明
    • --depth 複雑度、--visual 図表、--examples コード例

運用コマンド（6個）

  • /user:deploy - アプリケーションデプロイ
  • /user:migrate - データベース/コード移行
  • /user:scan - セキュリティと検証
  • /user:estimate - 時間/複雑度予測
  • /user:cleanup - プロジェクトメンテナンス
  • /user:git - Gitワークフロー管理

設計とアーキテクチャコマンド（1個）

  • /user:design - システム設計
    • --api REST、--ddd ドメイン駆動設計、--prd 要件、--openapi 仕様、--graphql GraphQL

ワークフローコマンド（2個）

  • /user:spawn - 専門化されたサブエージェントの作成
  • /user:document - ドキュメント作成

システムコマンド（1個）

  • /user:load - プロジェクトコンテキストのロード

🔧 MCP（モデルコンテキストプロトコル）統合

SuperClaudeは、4つの強力なMCPサーバーを統合しています。

  1. Context7 (C7) - 自動ドキュメント検索

    • ライブラリドキュメントを即座に検索
    • GitHubワークフローとシームレスに統合

  2. Sequential - 複雑な分析

    • 深い問題に対する順次思考
    • システム設計や根本原因分析に適している

  3. Magic - UI生成

    • Reactコンポーネントを自動作成
    • スマートなUI構築

  4. Puppeteer - ブラウザテスト

    • UIコンポーネントの検証
    • パフォーマンス監視

🚀 コア優位性

トークン最適化

  • UltraCompressedモード：70%のトークン削減
  • 電報スタイルによる簡素化：冠詞/接続詞/前置詞の削除
  • 記号化：→(へ), &(と), @(で), w/(と共に), +(追加), -(削除)
  • 略語：cfg(設定), fn(関数), impl(実装)

研究優先方法

  • 公式ドキュメントの自動検索
  • 根拠に基づいた意思決定
  • 引用駆動の実装

適応的思考

  • タスクに応じて分析深度を調整
  • スマートなツール選択
  • コンテキストを認識した応答

インストールと設定

自動インストール

git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
./install.sh

手動インストール

# 1. 構造の作成
mkdir -p ~/.claude/commands/shared

# 2. 設定ファイルのコピー
cp CLAUDE.md RULES.md PERSONAS.md MCP.md ~/.claude/

# 3. コマンドのコピー
cp .claude/commands/*.md ~/.claude/commands/

# 4. 共有リソースのコピー
cp .claude/commands/shared/*.yml ~/.claude/commands/shared/

インストールの検証

# インストールの確認
ls -la ~/.claude/ # 4つの主要ファイルが表示されるはず
ls -la ~/.claude/commands/ # 17ファイル（16コマンド + インデックス）が表示されるはず

# 使用テスト
# Claude Codeで任意のプロジェクトを開き、試してください：
/user:analyze --code
/persona:architect

プロジェクト構造

~/.claude/
├── CLAUDE.md          # メイン設定（他のファイルをロード）
├── RULES.md           # ガバナンスとプラクティス
├── PERSONAS.md        # 9つの認知プロトタイプ
├── MCP.md             # モデルコンテキストプロトコルパターン
└── commands/          # 17の専門化スラッシュコマンド + インデックス
    ├── analyze.md
    ├── build.md
    ├── cleanup.md
    ├── deploy.md
    ├── design.md
    ├── dev-setup.md
    ├── document.md
    ├── estimate.md
    ├── explain.md
    ├── git.md
    ├── improve.md
    ├── index.md
    ├── load.md
    ├── migrate.md
    ├── scan.md
    ├── spawn.md
    ├── test.md
    ├── troubleshoot.md
    └── shared/        # 19の設定リソース
        ├── ambiguity-check.yml
        ├── audit.yml
        ├── checkpoint.yml
        ├── cleanup-patterns.yml
        ├── command-memory.yml
        ├── documentation-dirs.yml
        ├── evidence.yml
        ├── git-operations.yml
        ├── git-workflow.yml
        ├── impl.yml
        ├── loading-cfg.yml
        ├── mcp-flags.yml
        ├── patterns.yml
        ├── performance-monitoring.yml
        ├── planning-mode.yml
        ├── research-first.yml
        ├── thinking-modes.yml
        ├── ultracompressed.yml
        └── validation.yml

使用例

汎用フラグ

すべてのコマンドがサポートする汎用フラグ：

計画と思考

  • --plan - 実行前に実行計画を表示
  • --think - 標準分析モード（複数ファイルコンテキスト）
  • --think-hard - 詳細分析モード（アーキテクチャレベル）
  • --ultrathink - 重要な分析モード（システムレベル）

ドキュメント制御

  • --ultracompressed / --uc - 約70%のトークン削減モード

MCPサーバー制御

  • --c7 / --no-c7 - Context7ドキュメントの有効化/無効化
  • --seq / --no-seq - Sequential思考の有効化/無効化
  • --magic / --no-magic - Magic UIビルダーの有効化/無効化
  • --pup / --no-pup - Puppeteerブラウザの有効化/無効化
  • --all-mcp - すべてのMCPサーバーを有効化
  • --no-mcp - すべてのMCPサーバーを無効化（ネイティブツールのみ）

ワークフロー例

完全な開発プロセス

/persona:architect → /user:load --depth deep → /user:analyze --architecture
/user:design --api --ddd → /user:estimate --detailed
/persona:backend → /user:build --api
/persona:frontend → /user:build --react → /user:test --coverage
/persona:security → /user:scan --security → /user:improve --quality
/user:cleanup --all → /user:deploy --env staging

デバッグワークフロー

/persona:analyzer → /user:troubleshoot --investigate --prod → /user:analyze --profile
"think hard about performance bottlenecks" → /user:troubleshoot --five-whys
/persona:performance → /user:improve --performance --iterate --threshold 90%

テストと品質保証

/persona:qa → /user:test --e2e → /user:scan --validate
/persona:mentor → /user:explain --depth beginner --visual --examples
/user:document --user → /user:build --tdd → /user:analyze --code

ドキュメント組織

操作ドキュメント vs プロジェクトドキュメント

SuperClaudeは、操作レポートとプロジェクトドキュメントを自動的に分離します。

.claudedocs/           # Claude操作ドキュメント
├── audit/
├── reports/
├── summaries/
├── metrics/
└── incidents/

/docs                  # プロジェクトドキュメント
├── api/
├── guides/
├── architecture/
└── development/

自動レポート

  • analyze → reports/
  • scan → reports/
  • test → metrics/
  • troubleshoot → incidents/

手動ドキュメント

  • /user:document → API → /docs/api/
  • ガイド → /docs/guides/

高度な機能

モデル適応

  • 簡単なタスク → sonnet（費用対効果）
  • 複雑なタスク → sonnet-4（バランス）
  • 重要なタスク → opus-4（最大能力）

便利なコマンド

  • /compact - スマートな削減
  • /clear - 新しい開始
  • /model - モデルの切り替え

チェックポイントシステム

Git統合されたチェックポイントシステムにより、開発者はワークフロー内の任意の時点に戻ることができます。

/user:git --checkpoint before-refactor
/user:git --rollback

トラブルシューティング

よくある質問

  1. コマンドが機能しない：ls ~/.claude/commands/ を確認してください（17ファイルが表示されるはずです）
  2. 計画の問題：--plan フラグを追加してください → /user:deploy --plan
  3. 役割の問題：/persona:architect → /persona:security → /user:scan --security
  4. MCPの問題："React docs" → C7 | "slow app" → Sequential

メンテナンスコマンド

  • 更新：cd SuperClaude && git pull && ./install.sh
  • バックアップ：cp -r ~/.claude/ ~/.claude.backup.$(date +%Y%m%d)
  • アンインストール：rm -rf ~/.claude/

プロジェクトの利点

開発者の利点

  • ✅ すべてのプロジェクトで一貫したワークフロー
  • ✅ 研究優先方法 → 常に公式ドキュメントを検索
  • ✅ 品質基準 → ベストプラクティスを内蔵
  • ✅ 認知専門化 → 各タスクに適切な思考パターン

適用シナリオ

  • 開発者 → より速く、よりスマートなコーディングワークフロー
  • チーム → 一貫したAI支援パターン
  • プロジェクト → 品質重視の開発
  • 学習 → AIガイドによるスキル開発

技術的特徴

記号システム

SuperClaudeは、効率を高めるために独自の記号システムを使用しています。

記号 意味 略語 意味
→ 導く cfg 設定
& と/および fn 関数
w/ と共に impl 実装
@ で/に env 環境
+ 追加/含む dev 開発
- 削除/除く auth 認証
∀ すべての/各 API アプリケーションプログラミングインターフェース

バージョン情報

  • 現在のバージョン：v4.0.0
  • タイプ：設定フレームワーク（実行可能コードではありません）
  • 互換性：Claude Code
  • インストール場所：~/.claude/（グローバルインストール）

まとめ

SuperClaudeは、Claude Codeを汎用AIアシスタントから専門化された開発パートナーへと変貌させます。提供される機能は以下の通りです。

  • 専門化された認知役割システム
  • 包括的なコマンドツールセット
  • スマートなMCP統合
  • 効率的なトークン最適化
  • 研究駆動の方法論

このフレームワークは、一貫性のある高品質なAI支援開発体験を必要とする開発者やチームに特に適しています。そのモジュール設計と専門化されたアプローチにより、SuperClaudeは各開発タスクが適切な専門知識とツールサポートを受けられるようにします。

Star History Chart