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. ユーザーガイド更新
|