mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-17 17:56:46 +00:00
104 lines
3.6 KiB
Markdown
104 lines
3.6 KiB
Markdown
|
# アーキテクチャ概要
|
|||
|
|
|
|||
|
|
## プロジェクト構造
|
|||
|
|
|
|||
|
|
### メインパッケージ（superclaude/）
|
|||
|
|
```
|
|||
|
|
superclaude/
|
|||
|
|
├── __init__.py # パッケージ初期化
|
|||
|
|
├── __main__.py # CLIエントリーポイント
|
|||
|
|
├── core/ # コア機能
|
|||
|
|
├── modes/ # 行動モード（7種類）
|
|||
|
|
│ ├── Brainstorming # 要件探索
|
|||
|
|
│ ├── Business_Panel # ビジネス分析
|
|||
|
|
│ ├── DeepResearch # 深層研究
|
|||
|
|
│ ├── Introspection # 内省分析
|
|||
|
|
│ ├── Orchestration # ツール調整
|
|||
|
|
│ ├── Task_Management # タスク管理
|
|||
|
|
│ └── Token_Efficiency # トークン効率化
|
|||
|
|
├── agents/ # 専門エージェント（16種類）
|
|||
|
|
├── mcp/ # MCPサーバー統合（8種類）
|
|||
|
|
├── commands/ # スラッシュコマンド（26種類）
|
|||
|
|
└── examples/ # 使用例
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### セットアップパッケージ（setup/）
|
|||
|
|
```
|
|||
|
|
setup/
|
|||
|
|
├── __init__.py
|
|||
|
|
├── core/ # インストーラーコア
|
|||
|
|
├── utils/ # ユーティリティ関数
|
|||
|
|
├── cli/ # CLIインターフェース
|
|||
|
|
├── components/ # インストール可能コンポーネント
|
|||
|
|
│ ├── agents.py # エージェント設定
|
|||
|
|
│ ├── mcp.py # MCPサーバー設定
|
|||
|
|
│ └── ...
|
|||
|
|
├── data/ # 設定データ（JSON/YAML）
|
|||
|
|
└── services/ # サービスロジック
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 主要コンポーネント
|
|||
|
|
|
|||
|
|
### CLIエントリーポイント（__main__.py）
|
|||
|
|
- `main()`: メインエントリーポイント
|
|||
|
|
- `create_parser()`: 引数パーサー作成
|
|||
|
|
- `register_operation_parsers()`: サブコマンド登録
|
|||
|
|
- `setup_global_environment()`: グローバル環境設定
|
|||
|
|
- `display_*()`: ユーザーインターフェース関数
|
|||
|
|
|
|||
|
|
### インストールシステム
|
|||
|
|
- **コンポーネントベース**: モジュラー設計
|
|||
|
|
- **フォールバック機能**: レガシーサポート
|
|||
|
|
- **設定管理**: `~/.claude/` ディレクトリ
|
|||
|
|
- **MCPサーバー**: Node.js統合
|
|||
|
|
|
|||
|
|
## デザインパターン
|
|||
|
|
|
|||
|
|
### 責任の分離
|
|||
|
|
- **setup/**: インストールとコンポーネント管理
|
|||
|
|
- **superclaude/**: ランタイム機能と動作
|
|||
|
|
- **tests/**: テストとバリデーション
|
|||
|
|
- **docs/**: ドキュメントとガイド
|
|||
|
|
|
|||
|
|
### プラグインアーキテクチャ
|
|||
|
|
- モジュラーコンポーネントシステム
|
|||
|
|
- 動的ロードと登録
|
|||
|
|
- 拡張可能な設計
|
|||
|
|
|
|||
|
|
### 設定ファイル階層
|
|||
|
|
1. `~/.claude/CLAUDE.md` - グローバルユーザー設定
|
|||
|
|
2. プロジェクト固有 `CLAUDE.md` - プロジェクト設定
|
|||
|
|
3. `~/.claude/.claude.json` - Claude Code設定
|
|||
|
|
4. MCPサーバー設定ファイル
|
|||
|
|
|
|||
|
|
## 統合ポイント
|
|||
|
|
|
|||
|
|
### Claude Code統合
|
|||
|
|
- スラッシュコマンド注入
|
|||
|
|
- 行動指示インジェクション
|
|||
|
|
- セッション永続化
|
|||
|
|
|
|||
|
|
### MCPサーバー
|
|||
|
|
1. **Context7**: ライブラリドキュメント
|
|||
|
|
2. **Sequential**: 複雑な分析
|
|||
|
|
3. **Magic**: UIコンポーネント生成
|
|||
|
|
4. **Playwright**: ブラウザテスト
|
|||
|
|
5. **Morphllm**: 一括変換
|
|||
|
|
6. **Serena**: セッション永続化
|
|||
|
|
7. **Tavily**: Web検索
|
|||
|
|
8. **Chrome DevTools**: パフォーマンス分析
|
|||
|
|
|
|||
|
|
## 拡張ポイント
|
|||
|
|
|
|||
|
|
### 新規コンポーネント追加
|
|||
|
|
1. `setup/components/` に実装
|
|||
|
|
2. `setup/data/` に設定追加
|
|||
|
|
3. テストを `tests/` に追加
|
|||
|
|
4. ドキュメントを `docs/` に追加
|
|||
|
|
|
|||
|
|
### 新規エージェント追加
|
|||
|
|
1. トリガーキーワード定義
|
|||
|
|
2. 機能説明作成
|
|||
|
|
3. 統合テスト追加
|
|||
|
|
4. ユーザーガイド更新
|