ユーザガイド (#311)

This commit is contained in:
Hayashi Kuniyuki
2025-08-27 01:16:11 +09:00
committed by GitHub
parent 3e34958d8a
commit 974630db5d
6 changed files with 3292 additions and 0 deletions

1029
Docs/User-Guide-jp/agents.md Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,415 @@
# SuperClaude コマンドガイド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#superclaude-commands-guide)
`/sc:*`SuperClaude は、ワークフロー用コマンドと`@agent-*`スペシャリスト用コマンドの 21 個の Claude Code コマンドを提供します。
## コマンドの種類
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-types)
|タイプ|使用場所|形式|例|
|---|---|---|---|
|**スラッシュコマンド**|クロード・コード|`/sc:[command]`|`/sc:implement "feature"`|
|**エージェント**|クロード・コード|`@agent-[name]`|`@agent-security "review"`|
|**インストール**|ターミナル|`SuperClaude [command]`|`SuperClaude install`|
## クイックテスト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#quick-test)
```shell
# Terminal: Verify installation
python3 -m SuperClaude --version
# Claude Code CLI verification: claude --version
# Claude Code: Test commands
/sc:brainstorm "test project" # Should ask discovery questions
/sc:analyze README.md # Should provide analysis
```
**ワークフロー**`/sc:brainstorm "idea"`→→`/sc:implement "feature"``/sc:test`
## 🎯 SuperClaude コマンドの理解
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-understanding-superclaude-commands)
## SuperClaudeの仕組み
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#how-superclaude-works)
SuperClaude は、Claude Code が特殊な動作を実行するために読み込む動作コンテキストファイルを提供します。 と入力すると`/sc:implement`、Claude Code は`implement.md`コンテキストファイルを読み込み、その動作指示に従います。
**SuperClaude コマンドはソフトウェアによって実行されるのではなく**、フレームワークから特殊な命令ファイルを読み取ることで Claude コードの動作を変更するコンテキスト トリガーです。
### コマンドの種類:
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-types-1)
- **スラッシュコマンド**`/sc:*`):ワークフローパターンと動作​​モードをトリガーする
- **エージェントの呼び出し**`@agent-*`):特定のドメインスペシャリストを手動で起動する
- **フラグ**`--think``--safe-mode`):コマンドの動作と深さを変更する
### コンテキストメカニズム:
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#the-context-mechanism)
1. **ユーザー入力**: 入力する`/sc:implement "auth system"`
2. **コンテキスト読み込み**: クロードコード読み取り`~/.claude/SuperClaude/Commands/implement.md`
3. **行動の採用**:クロードはドメインの専門知識、ツールの選択、検証パターンを適用します
4. **強化された出力**: セキュリティ上の考慮事項とベストプラクティスを備えた構造化された実装
**重要なポイント**: これにより、従来のソフトウェア実行ではなくコンテキスト管理を通じて洗練された開発ワークフローが作成されます。
### インストールコマンドと使用コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#installation-vs-usage-commands)
**🖥️ ターミナルコマンド**(実際の CLI ソフトウェア):
- `SuperClaude install`- フレームワークコンポーネントをインストールします
- `SuperClaude update`- 既存のインストールを更新します
- `SuperClaude uninstall`- フレームワークのインストールを削除します
- `python3 -m SuperClaude --version`- インストール状態を確認する
**💬 クロード コード コマンド**(コンテキスト トリガー):
- `/sc:brainstorm`- 要件検出コンテキストをアクティブ化します
- `/sc:implement`- 機能開発コンテキストをアクティブ化します
- `@agent-security`- セキュリティスペシャリストのコンテキストをアクティブ化します
- すべてのコマンドはClaude Codeチャットインターフェース内でのみ機能します
> **クイック スタート**: `/sc:brainstorm "your project idea"`→ `/sc:implement "feature name"`→を試して`/sc:test`、コア ワークフローを体験してください。
## 🧪 セットアップのテスト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-testing-your-setup)
### 🖥️ ターミナル検証(ターミナル/CMDで実行
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#%EF%B8%8F-terminal-verification-run-in-terminalcmd)
```shell
# Verify SuperClaude is working (primary method)
python3 -m SuperClaude --version
# Example output: SuperClaude 4.0.8
# Claude Code CLI version check
claude --version
# Check installed components
python3 -m SuperClaude install --list-components | grep mcp
# Example output: Shows installed MCP components
```
### 💬 クロードコードテスト(クロードコードチャットに入力)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-claude-code-testing-type-in-claude-code-chat)
```
# Test basic /sc: command
/sc:brainstorm "test project"
# Example behavior: Interactive requirements discovery starts
# Test command help
/sc:help
# Example behavior: List of available commands
```
**テストが失敗した場合**:[インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md)または[トラブルシューティングを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#troubleshooting)
### 📝 コマンドクイックリファレンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#-command-quick-reference)
|コマンドタイプ|走る場所|形式|目的|例|
|---|---|---|---|---|
|**🖥️ インストール**|ターミナル/CMD|`SuperClaude [command]`|セットアップとメンテナンス|`SuperClaude install`|
|**🔧 構成**|ターミナル/CMD|`python3 -m SuperClaude [command]`|高度な設定|`python3 -m SuperClaude --version`|
|**💬 スラッシュコマンド**|クロード・コード|`/sc:[command]`|ワークフロー自動化|`/sc:implement "feature"`|
|**🤖 エージェントの呼び出し**|クロード・コード|`@agent-[name]`|手動スペシャリストの有効化|`@agent-security "review"`|
|**⚡ 強化されたフラグ**|クロード・コード|`/sc:[command] --flags`|行動修正|`/sc:analyze --think-hard`|
> **注意**:すべての`/sc:`コマンドと`@agent-`呼び出しは、ターミナルではなくClaude Codeチャット内で動作します。これらのコマンドと呼び出しは、Claude CodeがSuperClaudeフレームワークから特定のコンテキストファイルを読み取るようにトリガーします。
## 目次
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#table-of-contents)
- [必須コマンド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#essential-commands)- ここから始めましょう8つのコアコマンド
- [一般的なワークフロー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#common-workflows)- 機能するコマンドの組み合わせ
- [完全なコマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#full-command-reference)- カテゴリ別に整理された全21個のコマンド
- [トラブルシューティング](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#troubleshooting)- よくある問題と解決策
- [コマンドインデックス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-index)- カテゴリ別にコマンドを検索
---
## 必須コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#essential-commands)
**即時の生産性向上のためのコアワークフロー コマンド:**
### `/sc:brainstorm`- プロジェクト発見
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scbrainstorm---project-discovery)
**目的**: 対話型の要件検出とプロジェクト計画
**構文**:`/sc:brainstorm "your idea"` `[--strategy systematic|creative]`
**ユースケース**:
- 新しいプロジェクトの計画:`/sc:brainstorm "e-commerce platform"`
- 機能の探索:`/sc:brainstorm "user authentication system"`
- 問題解決:`/sc:brainstorm "slow database queries"`
### `/sc:implement`- 機能開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scimplement---feature-development)
**目的**: インテリジェントなスペシャリストルーティングによるフルスタック機能の実装
**構文**:`/sc:implement "feature description"` `[--type frontend|backend|fullstack] [--focus security|performance]`
**ユースケース**:
- 認証:`/sc:implement "JWT login system"`
- UI コンポーネント:`/sc:implement "responsive dashboard"`
- API:`/sc:implement "REST user endpoints"`
- データベース:`/sc:implement "user schema with relationships"`
### `/sc:analyze`- コード評価
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scanalyze---code-assessment)
**目的**: 品質、セキュリティ、パフォーマンスにわたる包括的なコード分析
**構文**:`/sc:analyze [path]` `[--focus quality|security|performance|architecture]`
**ユースケース**:
- プロジェクトの健全性:`/sc:analyze .`
- セキュリティ監査:`/sc:analyze --focus security`
- パフォーマンスレビュー:`/sc:analyze --focus performance`
### `/sc:troubleshoot`- 問題診断
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#sctroubleshoot---problem-diagnosis)
**目的**: 根本原因分析による体系的な問題診断
**構文**:`/sc:troubleshoot "issue description"` `[--type build|runtime|performance]`
**ユースケース**:
- ランタイムエラー:`/sc:troubleshoot "500 error on login"`
- ビルドの失敗:`/sc:troubleshoot --type build`
- パフォーマンスの問題:`/sc:troubleshoot "slow page load"`
### `/sc:test`- 品質保証
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#sctest---quality-assurance)
**目的**: カバレッジ分析による包括的なテスト
**構文**:`/sc:test` `[--type unit|integration|e2e] [--coverage] [--fix]`
**ユースケース**:
- 完全なテストスイート:`/sc:test --coverage`
- ユニットテスト:`/sc:test --type unit --watch`
- E2E検証:`/sc:test --type e2e`
### `/sc:improve`- コード強化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scimprove---code-enhancement)
**目的**: 体系的なコードの改善と最適化を適用する
**構文**:`/sc:improve [path]` `[--type performance|quality|security] [--preview]`
**ユースケース**:
- 一般的な改善点:`/sc:improve src/`
- パフォーマンスの最適化:`/sc:improve --type performance`
- セキュリティ強化:`/sc:improve --type security`
### `/sc:document`- ドキュメント生成
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scdocument---documentation-generation)
**目的**: コードとAPIの包括的なドキュメントを生成する
**構文**:`/sc:document [path]` `[--type api|user-guide|technical] [--format markdown|html]`
**ユースケース**:
- APIドキュメント:`/sc:document --type api`
- ユーザーガイド:`/sc:document --type user-guide`
- 技術ドキュメント:`/sc:document --type technical`
### `/sc:workflow`- 実装計画
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#scworkflow---implementation-planning)
**目的**: 要件から構造化された実装計画を生成する
**構文**:`/sc:workflow "feature description"` `[--strategy agile|waterfall] [--format markdown]`
**ユースケース**:
- 機能計画:`/sc:workflow "user authentication"`
- スプリント計画:`/sc:workflow --strategy agile`
- アーキテクチャ計画:`/sc:workflow "microservices migration"`
---
## 一般的なワークフロー
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#common-workflows)
**実証済みのコマンドの組み合わせ:**
### 新しいプロジェクトのセットアップ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#new-project-setup)
```shell
/sc:brainstorm "project concept" # Define requirements
/sc:design "system architecture" # Create technical design
/sc:workflow "implementation plan" # Generate development roadmap
```
### 機能開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#feature-development)
```shell
/sc:implement "feature name" # Build the feature
/sc:test --coverage # Validate with tests
/sc:document --type api # Generate documentation
```
### コード品質の改善
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#code-quality-improvement)
```shell
/sc:analyze --focus quality # Assess current state
/sc:improve --preview # Preview improvements
/sc:test --coverage # Validate changes
```
### バグ調査
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#bug-investigation)
```shell
/sc:troubleshoot "issue description" # Diagnose the problem
/sc:analyze --focus problem-area # Deep analysis
/sc:improve --fix --safe-mode # Apply targeted fixes
```
## 完全なコマンドリファレンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#full-command-reference)
### 開発コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#development-commands)
|指示|目的|最適な用途|
|---|---|---|
|**ワークフロー**|実施計画|プロジェクトロードマップ、スプリント計画|
|**埋め込む**|機能開発|フルスタック機能、API開発|
|**建てる**|プロジェクトのコンパイル|CI/CD、プロダクションビルド|
|**デザイン**|システムアーキテクチャ|API仕様、データベーススキーマ|
### 分析コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#analysis-commands)
|指示|目的|最適な用途|
|---|---|---|
|**分析する**|コード評価|品質監査、セキュリティレビュー|
|**トラブルシューティング**|問題診断|バグ調査、パフォーマンスの問題|
|**説明する**|コードの説明|学習、コードレビュー|
### 品質コマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#quality-commands)
|指示|目的|最適な用途|
|---|---|---|
|**改善する**|コード強化|パフォーマンスの最適化、リファクタリング|
|**掃除**|技術的負債|デッドコードの削除、整理|
|**テスト**|品質保証|テスト自動化、カバレッジ分析|
|**書類**|ドキュメント|APIドキュメント、ユーザーガイド|
### プロジェクト管理
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#project-management)
|指示|目的|最適な用途|
|---|---|---|
|**見積もり**|プロジェクト見積もり|タイムライン計画、リソース割り当て|
|**タスク**|タスク管理|複雑なワークフロー、タスク追跡|
|**スポーン**|メタオーケストレーション|大規模プロジェクト、並列実行|
### ユーティリティコマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#utility-commands)
|指示|目的|最適な用途|
|---|---|---|
|**ギット**|バージョン管理|コミット管理、ブランチ戦略|
|**索引**|コマンド検出|機能の探索、コマンドの検索|
### セッションコマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#session-commands)
|指示|目的|最適な用途|
|---|---|---|
|**負荷**|コンテキストの読み込み|セッションの初期化、プロジェクトのオンボーディング|
|**保存**|セッションの永続性|チェックポイント、コンテキスト保存|
|**反映する**|タスクの検証|進捗評価、完了検証|
|**選択ツール**|ツールの最適化|パフォーマンスの最適化、ツールの選択|
---
## コマンドインデックス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#command-index)
**機能別:**
- **計画**:ブレインストーミング、設計、ワークフロー、見積もり
- **開発**実装、ビルド、git
- **分析**:分析、トラブルシューティング、説明
- **品質**: 改善、クリーンアップ、テスト、ドキュメント化
- **管理**: タスク、スポーン、ロード、保存、反映
- **ユーティリティ**: インデックス、選択ツール
**複雑さ別:**
- **初心者**:ブレインストーミング、実装、分析、テスト
- **中級**:ワークフロー、設計、改善、ドキュメント
- **上級**:スポーン、タスク、選択ツール、リフレクト
## トラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#troubleshooting)
**コマンドの問題:**
- **コマンドが見つかりません**: インストールを確認してください:`python3 -m SuperClaude --version`
- **応答なし**: Claude Codeセッションを再開する
- **処理遅延**: `--no-mcp`MCPサーバーなしでテストするために使用します
**クイックフィックス:**
- セッションをリセット:`/sc:load`再初期化する
- ステータスを確認:`SuperClaude install --list-components`
- ヘルプ:[トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)
## 次のステップ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#next-steps)
- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)- コマンドの動作を制御する
- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md)- スペシャリストのアクティベーション
- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)- 実際の使用パターン

388
Docs/User-Guide-jp/flags.md Normal file
View File

@@ -0,0 +1,388 @@
# SuperClaude フラグガイド 🏁
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#superclaude-flags-guide-)
**ほとんどのフラグは自動的にアクティブになります**。Claude Code は、リクエスト内のキーワードとパターンに基づいて適切なコンテキストを実行するための動作指示を読み取ります。
## 必須の自動アクティベーションフラグユースケースの90%
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#essential-auto-activation-flags-90-of-use-cases)
### コア分析フラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#core-analysis-flags)
|フラグ|起動時|何をするのか|
|---|---|---|
|`--think`|5つ以上のファイルまたは複雑な分析|標準的な構造化分析約4Kトークン|
|`--think-hard`|アーキテクチャ分析、システム依存関係|強化されたツールによる詳細な分析約1万トークン|
|`--ultrathink`|重要なシステムの再設計、レガシーシステムの近代化|すべてのツールで最大深度分析約32Kトークン|
### MCP サーバーフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#mcp-server-flags)
|フラグ|サーバ|目的|自動トリガー|
|---|---|---|---|
|`--c7`/`--context7`|コンテキスト7|公式ドキュメント、フレームワークパターン|ライブラリのインポート、フレームワークに関する質問|
|`--seq`/`--sequential`|一連|多段階推論、デバッグ|複雑なデバッグ、システム設計|
|`--magic`|魔法|UIコンポーネント生成|`/ui`コマンド、フロントエンドキーワード|
|`--play`/`--playwright`|劇作家|ブラウザテスト、E2E検証|テスト要求、視覚的検証|
|`--morph`/`--morphllm`|モルフィム|一括変換、パターン編集|一括操作、スタイルの強制|
|`--serena`|セレナ|プロジェクトメモリ、シンボル操作|シンボル操作、大規模なコードベース|
### 動作モードフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#behavioral-mode-flags)
|フラグ|起動時|何をするのか|
|---|---|---|
|`--brainstorm`|漠然とした要望、探索キーワード|共同発見のマインドセット|
|`--introspect`|自己分析、エラー回復|推論プロセスを透明性を持って公開する|
|`--task-manage`|>3ステップ、複雑なスコープ|委任を通じて調整する|
|`--orchestrate`|マルチツール操作、パフォーマンスニーズ|ツールの選択と並列実行の最適化|
|`--token-efficient`/`--uc`|コンテキスト >75%、効率性のニーズ|シンボル強化通信、3050%削減|
### 実行制御フラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#execution-control-flags)
|フラグ|起動時|何をするのか|
|---|---|---|
|`--loop`|「改善する」「磨く」「洗練する」というキーワード|反復的な強化サイクル|
|`--safe-mode`|生産、リソース使用率85%以上|最大限の検証、慎重な実行|
|`--validate`|リスク >0.7、本番環境|実行前のリスク評価|
|`--delegate`|>7 ディレクトリまたは >50 ファイル|サブエージェント並列処理|
## コマンド固有のフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#command-specific-flags)
### 分析コマンドフラグ(`/sc:analyze`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#analysis-command-flags-scanalyze)
|フラグ|目的|価値観|
|---|---|---|
|`--focus`|特定のドメインをターゲットとする|`security`、、、、`performance``quality``architecture`|
|`--depth`|分析の徹底性|`quick``deep`|
|`--format`|出力形式|`text`、、`json``report`|
### ビルドコマンドフラグ(`/sc:build`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#build-command-flags-scbuild)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|ビルド構成|`dev`、、`prod``test`|
|`--clean`|ビルド前にクリーンアップ|ブール値|
|`--optimize`|最適化を有効にする|ブール値|
|`--verbose`|詳細な出力|ブール値|
### 設計コマンドフラグ(`/sc:design`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#design-command-flags-scdesign)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|設計目標|`architecture`、、、、`api``component``database`|
|`--format`|出力形式|`diagram`、、`spec``code`|
### コマンドフラグの説明(`/sc:explain`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#explain-command-flags-scexplain)
|フラグ|目的|価値観|
|---|---|---|
|`--level`|複雑さのレベル|`basic`、、`intermediate``advanced`|
|`--format`|説明スタイル|`text`、、`examples``interactive`|
|`--context`|ドメインコンテキスト|任意のドメイン(例:`react``security`|
### コマンドフラグの改善(`/sc:improve`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#improve-command-flags-scimprove)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|改善の焦点|`quality`、、、、、`performance``maintainability``style``security`|
|`--safe`|保守的なアプローチ|ブール値|
|`--interactive`|ユーザーガイダンス|ブール値|
|`--preview`|実行せずに表示する|ブール値|
### タスクコマンドフラグ(`/sc:task`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#task-command-flags-sctask)
|フラグ|目的|価値観|
|---|---|---|
|`--strategy`|タスクアプローチ|`systematic`、、`agile``enterprise`|
|`--parallel`|並列実行|ブール値|
|`--delegate`|サブエージェントの調整|ブール値|
### ワークフローコマンドフラグ(`/sc:workflow`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#workflow-command-flags-scworkflow)
|フラグ|目的|価値観|
|---|---|---|
|`--strategy`|ワークフローアプローチ|`systematic`、、`agile``enterprise`|
|`--depth`|分析の深さ|`shallow`、、`normal``deep`|
|`--parallel`|並列調整|ブール値|
### コマンドフラグのトラブルシューティング ( `/sc:troubleshoot`)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#troubleshoot-command-flags-sctroubleshoot)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|問題カテゴリ|`bug`、、、、`build``performance``deployment`|
|`--trace`|トレース分析を含める|ブール値|
|`--fix`|修正を適用する|ブール値|
### クリーンアップコマンドフラグ(`/sc:cleanup`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#cleanup-command-flags-sccleanup)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|クリーンアップ対象|`code`、、、、`imports``files``all`|
|`--safe`/`--aggressive`|清掃強度|ブール値|
|`--interactive`|ユーザーガイダンス|ブール値|
|`--preview`|実行せずに表示する|ブール値|
### コマンドフラグの推定(`/sc:estimate`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#estimate-command-flags-scestimate)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|焦点を推定する|`time`、、`effort``complexity`|
|`--unit`|時間単位|`hours`、、`days``weeks`|
|`--breakdown`|詳細な内訳|ブール値|
### インデックスコマンドフラグ(`/sc:index`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#index-command-flags-scindex)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|インデックスターゲット|`docs`、、、、`api``structure``readme`|
|`--format`|出力形式|`md`、、`json``yaml`|
### コマンドフラグを反映する ( `/sc:reflect`)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#reflect-command-flags-screflect)
|フラグ|目的|価値観|
|---|---|---|
|`--type`|反射スコープ|`task`、、`session``completion`|
|`--analyze`|分析を含める|ブール値|
|`--validate`|完全性を検証する|ブール値|
### スポーンコマンドフラグ(`/sc:spawn`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#spawn-command-flags-scspawn)
|フラグ|目的|価値観|
|---|---|---|
|`--strategy`|調整アプローチ|`sequential`、、`parallel``adaptive`|
|`--depth`|分析の深さ|`normal``deep`|
### Gitコマンドフラグ`/sc:git`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#git-command-flags-scgit)
|フラグ|目的|価値観|
|---|---|---|
|`--smart-commit`|コミットメッセージを生成する|ブール値|
|`--interactive`|ガイド付き操作|ブール値|
### 選択ツールコマンドフラグ ( `/sc:select-tool`)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#select-tool-command-flags-scselect-tool)
|フラグ|目的|価値観|
|---|---|---|
|`--analyze`|ツール分析|ブール値|
|`--explain`|選択の説明|ブール値|
### テストコマンドフラグ(`/sc:test`
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#test-command-flags-sctest)
|フラグ|目的|価値観|
|---|---|---|
|`--coverage`|カバー範囲を含める|ブール値|
|`--type`|テストの種類|`unit`、、`integration``e2e`|
|`--watch`|ウォッチモード|ブール値|
## 高度な制御フラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#advanced-control-flags)
### 範囲と焦点
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#scope-and-focus)
|フラグ|目的|価値観|
|---|---|---|
|`--scope`|分析境界|`file`、、、、`module``project``system`|
|`--focus`|ドメインターゲティング|`performance`、、、、、、`security``quality``architecture``accessibility``testing`|
### 実行制御
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#execution-control)
|フラグ|目的|価値観|
|---|---|---|
|`--concurrency [n]`|並列オペレーションを制御する|1-15|
|`--iterations [n]`|改善サイクル|1-10|
|`--all-mcp`|すべてのMCPサーバーを有効にする|ブール値|
|`--no-mcp`|ネイティブツールのみ|ブール値|
### システムフラグSuperClaude インストール)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#system-flags-superclaude-installation)
|フラグ|目的|価値観|
|---|---|---|
|`--verbose`/`-v`|詳細ログ|ブール値|
|`--quiet`/`-q`|出力を抑制する|ブール値|
|`--dry-run`|操作をシミュレーションする|ブール値|
|`--force`|チェックをスキップする|ブール値|
|`--yes`/`-y`|自動確認|ブール値|
|`--install-dir`|ターゲットディレクトリ|パス|
|`--legacy`|レガシースクリプトを使用する|ブール値|
|`--version`|バージョンを表示|ブール値|
|`--help`|ヘルプを表示|ブール値|
## 一般的な使用パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#common-usage-patterns)
### フロントエンド開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#frontend-development)
```shell
/sc:implement "responsive dashboard" --magic --c7
/sc:design component-library --type component --format code
/sc:test ui-components/ --magic --play
/sc:improve legacy-ui/ --magic --morph --validate
```
### バックエンド開発
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#backend-development)
```shell
/sc:analyze api/ --focus performance --seq --think
/sc:design payment-api --type api --format spec
/sc:troubleshoot "API timeout" --type performance --trace
/sc:improve auth-service --type security --validate
```
### 大規模プロジェクト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#large-projects)
```shell
/sc:analyze . --ultrathink --all-mcp --safe-mode
/sc:workflow enterprise-system --strategy enterprise --depth deep
/sc:cleanup . --type all --safe --interactive
/sc:estimate "migrate to microservices" --type complexity --breakdown
```
### 品質とメンテナンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#quality--maintenance)
```shell
/sc:improve src/ --type quality --safe --interactive
/sc:cleanup imports --type imports --preview
/sc:reflect --type completion --validate
/sc:git commit --smart-commit
```
## フラグインタラクション
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#flag-interactions)
### 互換性のある組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#compatible-combinations)
- `--think`+ `--c7`: ドキュメント付き分析
- `--magic`+ `--play`: テスト付きのUI生成
- `--serena`+ `--morph`: 変換によるプロジェクトメモリ
- `--safe-mode`+ `--validate`: 最大限の安全性
- `--loop`+ `--validate`: 検証を伴う反復的な改善
### 競合するフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#conflicting-flags)
- `--all-mcp`個別のMCPフラグと比較どちらか一方を使用
- `--no-mcp`任意のMCPフラグと比較--no-mcpが優先
- `--safe`vs `--aggressive`(クリーンアップ強度)
- `--quiet`vs `--verbose`(出力レベル)
### 関係の自動有効化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#auto-enabling-relationships)
- `--safe-mode`自動的`--uc`に有効になり、`--validate`
- `--ultrathink`すべてのMCPサーバーを自動的に有効にする
- `--think-hard`自動的に有効になります`--seq`+`--c7`
- `--magic`UIに重点を置いたエージェントを起動する
## トラブルシューティングフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#troubleshooting-flags)
### よくある問題
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#common-issues)
- **ツールが多すぎる**:`--no-mcp`ネイティブツールのみでテストする
- **操作が遅すぎます**:`--uc`出力を圧縮するために追加します
- **検証ブロッキング**:開発で`--validate`は代わりに使用してください`--safe-mode`
- **コンテキスト圧力**:`--token-efficient`使用率が75%を超えると自動的にアクティブ化されます
### デバッグフラグ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#debug-flags)
```shell
/sc:analyze . --verbose # Shows decision logic and flag activation
/sc:select-tool "operation" --explain # Explains tool selection process
/sc:reflect --type session --analyze # Reviews current session decisions
```
### クイックフィックス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#quick-fixes)
```shell
/sc:analyze . --help # Shows available flags for command
/sc:analyze . --no-mcp # Native execution only
/sc:cleanup . --preview # Shows what would be cleaned
```
## フラグの優先ルール
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#flag-priority-rules)
1. **安全第一**: `--safe-mode`> `--validate`> 最適化フラグ
2. **明示的なオーバーライド**: ユーザーフラグ > 自動検出
3. **深度階層**`--ultrathink`> `--think-hard`>`--think`
4. **MCP制御**:`--no-mcp`すべてのMCPフラグを上書きします
5. **スコープの優先順位**: システム > プロジェクト > モジュール > ファイル
## 関連リソース
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md#related-resources)
- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)- これらのフラグを使用するコマンド
- [MCP サーバーガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)- MCP フラグのアクティブ化について
- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)- 永続セッションでのフラグの使用

View File

@@ -0,0 +1,320 @@
# SuperClaude MCP サーバーガイド 🔌
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#superclaude-mcp-servers-guide-)
## 概要
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#overview)
MCPモデルコンテキストプロトコルサーバーは、専用ツールを通じてClaude Codeの機能を拡張します。SuperClaudeは6つのMCPサーバーを統合し、タスクに応じてサーバーをいつ起動するかをClaudeに指示します。
### 🔍 現実チェック
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#-reality-check)
- **MCPサーバーとは**: 追加ツールを提供する外部Node.jsプロセス
- **含まれていないもの**SuperClaude 機能が組み込まれている
- **アクティベーションの仕組み**: クロードは状況に応じて適切なサーバーを使用するための指示を読み上げます
- **提供されるもの**Claude Codeのネイティブ機能を拡張する実際のツール
**コアサーバー:**
- **context7** : 公式ライブラリドキュメントとパターン
- **段階的思考**:多段階の推論と分析
- **マジック**モダンなUIコンポーネント生成
- **プレイライト**ブラウザ自動化とE2Eテスト
- **morphllm-fast-apply** : パターンベースのコード変換
- **serena** : セマンティックコード理解とプロジェクトメモリ
## クイックスタート
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#quick-start)
**セットアップの確認**MCPサーバーは自動的に起動します。インストールとトラブルシューティングについては、[「インストールガイド」](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md)と[「トラブルシューティング」](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)を参照してください。
**自動アクティベーションロジック:**
|リクエストに含まれるもの|アクティブ化されたサーバー|
|---|---|
|ライブラリのインポート、API名|**コンテキスト7**|
|`--think`、デバッグ|**連続思考**|
|`component``UI`、 フロントエンド|**魔法**|
|`test`、、`e2e``browser`|**劇作家**|
|複数ファイルの編集、リファクタリング|**morphllm-高速適用**|
|大規模プロジェクト、セッション|**セレナ**|
## サーバーの詳細
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#server-details)
### コンテキスト7 📚
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#context7-)
**目的**: 公式ライブラリドキュメントへのアクセス **トリガー**: インポートステートメント、フレームワークキーワード、ドキュメントリクエスト **要件**: Node.js 16+、APIキーなし
```shell
# Automatic activation
/sc:implement "React authentication system"
# → Provides official React patterns
# Manual activation
/sc:analyze auth-system/ --c7
```
### 連続思考 🧠
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#sequential-thinking-)
**目的**: 構造化された多段階の推論と体系的な分析 **トリガー**: 複雑なデバッグ、`--think`フラグ、アーキテクチャ分析 **要件**: Node.js 16+、APIキーなし
```shell
# Automatic activation
/sc:troubleshoot "API performance issues"
# → Enables systematic root cause analysis
# Manual activation
/sc:analyze --think-hard architecture/
```
### 魔法✨
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#magic-)
**目的**: 21st.dev パターンからのモダン UI コンポーネント生成 **トリガー**: UI リクエスト、`/ui`コマンド、コンポーネント開発 **要件**: Node.js 16+、TWENTYFIRST_API_KEY()
```shell
# Automatic activation
/sc:implement "responsive dashboard component"
# → Generates accessible UI with modern patterns
# API key setup
export TWENTYFIRST_API_KEY="your_key_here"
```
### 劇作家🎭
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#playwright-)
**目的**: 実際のブラウザ自動化とE2Eテスト **トリガー**: ブラウザテスト、E2Eシナリオ、視覚的検証 **要件**: Node.js 16以上、APIキーなし
```shell
# Automatic activation
/sc:test --type e2e "user login flow"
# → Enables browser automation testing
# Manual activation
/sc:validate "accessibility compliance" --play
```
### morphllm-fast-apply 🔄
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#morphllm-fast-apply-)
**目的**: 効率的なパターンベースのコード変換 **トリガー**: 複数ファイルの編集、リファクタリング、フレームワークの移行 **要件**: Node.js 16+、MORPH_API_KEY
```shell
# Automatic activation
/sc:improve legacy-codebase/ --focus maintainability
# → Applies consistent patterns across files
# API key setup
export MORPH_API_KEY="your_key_here"
```
### セレナ🧭
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#serena-)
**目的**: プロジェクトメモリを使用したセマンティックコード理解 **トリガー**: シンボル操作、大規模コードベース、セッション管理 **要件**: Python 3.9+、UV パッケージマネージャー、API キーなし
```shell
# Automatic activation
/sc:load existing-project/
# → Builds project understanding and memory
# Manual activation
/sc:refactor "extract UserService" --serena
```
## 構成
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#configuration)
**MCP 構成ファイル ( `~/.claude.json`):**
```json
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
},
"magic": {
"command": "npx",
"args": ["@21st-dev/magic"],
"env": {"TWENTYFIRST_API_KEY": "${TWENTYFIRST_API_KEY}"}
},
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
},
"morphllm-fast-apply": {
"command": "npx",
"args": ["@morph-llm/morph-fast-apply"],
"env": {"MORPH_API_KEY": "${MORPH_API_KEY}"}
},
"serena": {
"command": "uv",
"args": ["run", "serena", "start-mcp-server", "--context", "ide-assistant"],
"cwd": "$HOME/.claude/serena"
}
}
}
```
## 使用パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#usage-patterns)
**サーバー制御:**
```shell
# Enable specific servers
/sc:analyze codebase/ --c7 --seq
# Disable all MCP servers
/sc:implement "simple function" --no-mcp
# Enable all servers
/sc:design "complex architecture" --all-mcp
```
**マルチサーバー調整:**
```shell
# Full-stack development
/sc:implement "e-commerce checkout"
# → Sequential: workflow analysis
# → Context7: payment patterns
# → Magic: UI components
# → Serena: code organization
# → Playwright: E2E testing
```
## トラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#troubleshooting)
**よくある問題:**
- **サーバーが接続されていません**: Node.js を確認してください: `node --version`(v16 以上が必要)
- **Context7 が失敗しました**: キャッシュをクリアしてください:`npm cache clean --force`
- **Magic/Morphllm エラー**: API キーがない場合に発生する可能性があります (有料サービス)
- **サーバーのタイムアウト**: Claude Codeセッションを再起動します
**クイックフィックス:**
```shell
# Reset connections
# Restart Claude Code session
# Check dependencies
node --version # Should show v16+
# Test without MCP
/sc:command --no-mcp
# Check configuration
ls ~/.claude.json
```
**API キーの設定:**
```shell
# For Magic server (required for UI generation)
export TWENTYFIRST_API_KEY="your_key_here"
# For Morphllm server (required for bulk transformations)
export MORPH_API_KEY="your_key_here"
# Add to shell profile for persistence
echo 'export TWENTYFIRST_API_KEY="your_key"' >> ~/.bashrc
echo 'export MORPH_API_KEY="your_key"' >> ~/.bashrc
```
**環境変数の使用法:**
- ✅ `TWENTYFIRST_API_KEY`- Magic MCP サーバー機能に必要
- ✅ `MORPH_API_KEY`- Morphllm MCP サーバー機能に必要
- ❌ ドキュメント内のその他の環境変数 - 例のみ、フレームワークでは使用されません
- 📝 どちらも有料のサービスAPIキーですが、フレームワークはそれらなしでも動作します
## サーバーの組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#server-combinations)
**APIキーなし無料** :
- コンテキスト7 + シーケンシャルシンキング + 劇作家 + セレナ
**1 APIキー**:
- プロフェッショナルなUI開発に魔法を加える
**2つのAPIキー**:
- 大規模リファクタリングのために morphllm-fast-apply を追加
**一般的なワークフロー:**
- **学習**コンテキスト7 + シーケンシャルシンキング
- **Web開発**:マジック + context7 + プレイライト
- **エンタープライズリファクタリング**serena + morphllm + sequential-thinking
- **複雑な分析**:シーケンシャルシンキング + コンテキスト7 + セレナ
## 統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#integration)
**SuperClaude コマンドを使用する場合:**
- 分析コマンドは自動的にSequential + Serenaを使用します
- 実装コマンドはMagic + Context7を使用する
- テストコマンドにはPlaywright + Sequentialを使用する
**動作モードの場合:**
- ブレインストーミングモード:発見のためのシーケンシャル
- タスク管理:永続性のための Serena
- オーケストレーションモード: 最適なサーバーの選択
**パフォーマンスコントロール:**
- システム負荷に基づく自動リソース管理
- 同時実行制御: `--concurrency N`(1-15)
- 制約下での優先度ベースのサーバー選択
## 関連リソース
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md#related-resources)
**必読:**
- [コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)- MCPサーバーをアクティブ化するコマンド
- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)- MCP セットアップガイド
**高度な使用法:**
- [行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md)- モード-MCP調整
- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md)- エージェントとMCPの統合
- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)- Serena ワークフロー
**技術リファレンス:**
- [例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)- MCP ワークフローパターン
- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/technical-architecture.md)- 統合の詳細

726
Docs/User-Guide-jp/modes.md Normal file
View File

@@ -0,0 +1,726 @@
# SuperClaude 行動モードガイド 🧠
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#superclaude-behavioral-modes-guide-)
## ✅ クイック検証
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-quick-verification)
コマンドを使用してモードをテストします`/sc:`。モードはタスクの複雑さに基づいて自動的にアクティブになります。コマンドの完全なリファレンスについては、[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)をご覧ください。
## クイックリファレンステーブル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#quick-reference-table)
|モード|目的|自動トリガー|重要な行動|最適な用途|
|---|---|---|---|---|
|**🧠 ブレインストーミング**|インタラクティブな発見|「ブレインストーミング」、「たぶん」、漠然とした要望|ソクラテス式の質問、要件の抽出|新しいプロジェクトの計画、不明確な要件|
|**🔍 内省**|メタ認知分析|エラー回復、「推論の分析」|透明な思考マーカー(🤔、🎯、💡)|デバッグ、学習、最適化|
|**📋 タスク管理**|複雑な調整|>3ステップ、>2ディレクトリ|相の崩壊、記憶の持続|多段階操作、プロジェクト管理|
|**🎯 オーケストレーション**|インテリジェントなツール選択|複数のツールを使用した操作、高いリソース使用率|最適なツールルーティング、並列実行|複雑な分析、パフォーマンスの最適化|
|**⚡ トークン効率**|圧縮通信|コンテキスト使用率が高い、`--uc`フラグ|シンボルシステム、推定3050%のトークン削減|リソースの制約、大規模な操作|
---
## はじめに2分の概要
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#getting-started-2-minute-overview)
**モードは動作指示を通じてアクティブ化されます**- Claude Code はコンテキスト ファイルを読み取り、タスクのパターンと複雑さに基づいてどのモード動作を採用するかを決定します。
**簡単な例:**
```shell
# Automatic activation examples
/sc:brainstorm "mobile app" # → Socratic discovery questions
/sc:implement "auth system" # → Multi-phase coordination
"--uc analyze large-codebase/" # → Compressed symbol output
```
**手動フラグを使用する場合:**
- 特定の動作が必要: `--brainstorm`、、`--introspect``--uc`
- 学習/デバッグのための自動検出をオーバーライドする
- 特定の制約(メモリ、時間、明瞭性)に合わせて最適化する
---
## モードの詳細
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-details)
### 🧠 ブレインストーミングモード - インタラクティブな発見
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-brainstorming-mode---interactive-discovery)
**目的**: 共同作業による発見を通じて、漠然としたアイデアを構造化された要件に変換します。
**自動アクティベーショントリガー:**
- 漠然としたプロジェクトリクエスト:「...を構築したい」、「...を作成しようと考えている」
- 探索キーワード: ブレインストーミング、探索、議論、理解、不明
- 不確実性指標:「たぶん」、「おそらく」、「できるかもしれない」
- 手動フラグ: `--brainstorm``--bs`
**行動の変化:**
- **ソクラテス式質問**:隠れた要件を明らかにするために掘り下げた質問をする
- **非推定的アプローチ**:推定を避け、発見の方向性を導く
- **協力的なパートナーシップ**:指示的な相談ではなく、探索的に協力します
- **要件統合**:洞察を構造化された技術概要に変換します
- **クロスセッションメモリ**:フォローアップの議論のために発見のコンテキストを維持する
**経験例:**
```
Standard Approach: "I'll build a user authentication system with JWT tokens..."
Brainstorming Approach:
"🤔 Let's explore this together:
- What specific user problems does auth solve for your app?
- Who are your users and what's their technical comfort level?
- Any existing systems or social logins to integrate with?
- What security/compliance requirements do you have?
📝 Outcome: Detailed auth requirements brief ready for implementation"
```
#### 成功基準
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#success-criteria)
- [ ] すぐに解決策を提示するのではなく、質問で応答する
- [ ] 質問はユーザーのニーズ、技術的制約、ビジネス目標を探ります
- [ ] 発見プロセス全体を通じて協力的な姿勢を維持する
- [ ] 結果として構造化された要件または技術概要を作成します
**検証:** `/sc:brainstorm "web app"`ユーザー、機能、テクノロジーについて質問する必要があります。
**テスト:**漠然としたリクエストは、推測ではなく発見のための質問を引き起こす必要があります。
**チェック:**モードは、同じ会話内のフォローアップの質問でも維持される必要があります。
**最適な組み合わせ:**
- **→ タスク管理**:要件の発見 → 体系的な実装計画
- **→ オーケストレーション**:要件の明確化 → 実装に最適なツールの選択
- **手動オーバーライド**: `--brainstorm`「明確な」要件であっても強制的に検出するために使用します
---
### 🔍 内省モード - メタ認知分析
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-introspection-mode---meta-cognitive-analysis)
**目的**: 学習の最適化と透明な意思決定のための推論プロセスを公開します。
**自動アクティベーショントリガー:**
- 自己分析の要求:「自分の推論を分析する」、「決定を振り返る」
- エラー回復シナリオと調査を必要とする予期しない結果
- 複数の実行可能なアプローチによる複雑な問題解決
- 最適化の機会のためのパターン認識の必要性
- 手動フラグ:`--introspect`
**行動の変化:**
- **推論の透明性**: 思考プロセスを明確なマーカーで公開します (🤔、🎯、⚡、📊、💡)
- **意思決定分析**:選択ロジックを評価し、代替アプローチを検討する
- **パターン認識**:繰り返される行動と改善の機会を特定します
- **メタ学習**:継続的なフレームワーク改善のための洞察を抽出
- **フレームワークコンプライアンス**: SuperClaude原則と品質ゲートに照らしてアクションを検証します
**経験例:**
```
Standard Approach: "I'll analyze this code structure and suggest improvements..."
Introspective Approach:
"🧠 Meta-Analysis: Why did I choose structural analysis over functional flow?
🎯 Decision Logic: Saw class hierarchy → assumed OOP pattern dominance
🔄 Alternative Considered: Data flow analysis might reveal hidden dependencies
📊 Evidence Check: File imports suggest functional composition, not OOP
💡 Learning: Need to analyze imports before choosing analysis strategy
⚡ Correction: Switching to functional flow analysis approach"
```
**最適な組み合わせ:**
- **→ タスク管理**: 複雑なフェーズの決定に透明な推論を提供します
- **任意のモード**: 他のモードの操作に推論の透明性レイヤーを追加します
- **手動オーバーライド**:`--introspect`学習セッションやワークフローのデバッグに使用します
---
### 📋 タスク管理モード - 複雑な調整
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-task-management-mode---complex-coordination)
**目的**: 複数ステップの操作のためのセッション永続性を備えた階層的なタスク構成。
**自動アクティベーショントリガー:**
- 3 つ以上の調整されたステップを必要とする操作
- 複数のファイル/ディレクトリ スコープ (ディレクトリが 2 つ以上、またはファイル数が 3 つ以上)
- フェーズとチェックポイントを必要とする複雑な依存関係
- 品質改善の要望:磨き、洗練、強化
- 手動フラグ: `--task-manage``--delegate`
**行動の変化:**
- **階層的計画**複雑な作業を計画→フェーズ→タスク→ToDo構造に分割します
- **セッションの永続性**: 中断があってもプロジェクトのコンテキストと進行状況を維持します
- **メモリ統合**: 状態保存のために write_memory/read_memory を使用する
- **進捗オーケストレーション**: 追跡のためにメモリ更新とTodoWriteを調整する
- **品質ゲート**:フェーズ間の体系的な検証チェックポイントを実装します
**経験例:**
```
Standard Approach: "I'll implement user authentication..." → Direct implementation
Task Management Approach:
"📋 Multi-Phase Implementation Plan:
🎯 Phase 1: Security Requirements Analysis (Session 1)
🎯 Phase 2: API Design & Documentation (Session 2)
🎯 Phase 3: Implementation & Testing (Session 3-4)
🎯 Phase 4: Integration & Validation (Session 5)
💾 Session persistence: Resume context automatically
✓ Quality gates: Validation before each phase transition"
```
**最適な組み合わせ:**
- **ブレインストーミング→**:要件発見と体系的な実装
- **+ オーケストレーション**: 最適なツール選択によるタスク調整
- **+ イントロスペクション**:複雑なフェーズの決定のための透過的な推論
---
### 🎯 オーケストレーションモード - インテリジェントなツール選択
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-orchestration-mode---intelligent-tool-selection)
**目的**: インテリジェントなツールルーティングと並列調整を通じてタスクの実行を最適化します。
**自動アクティベーショントリガー:**
- 高度な調整を必要とするマルチツール操作
- パフォーマンス制約(リソース使用量が多い)
- 並列実行の機会3つ以上の独立したファイル/操作)
- 複数の有効なツールアプローチによる複雑なルーティング決定
**行動の変化:**
- **インテリジェントツールルーティング**:各タスクタイプに最適なMCPサーバーとネイティブツールを選択します。
- **リソース認識**: システムの制約と可用性に基づいてアプローチを適応させます
- **並列最適化**: 同時実行のための独立した操作を識別します
- **調整の焦点**:調整された実行を通じてツールの選択と使用を最適化します
- **アダプティブフォールバック**: 優先オプションが利用できない場合にツールを適切に切り替えます
**経験例:**
```
Standard Approach: Sequential file-by-file analysis and editing
Orchestration Approach:
"🎯 Multi-Tool Coordination Strategy:
🔍 Phase 1: Serena (semantic analysis) + Sequential (architecture review)
⚡ Phase 2: Morphllm (pattern edits) + Magic (UI components)
🧪 Phase 3: Playwright (testing) + Context7 (documentation patterns)
🔄 Parallel execution: 3 tools working simultaneously
\"
```
**最適な組み合わせ:**
- **タスク管理 →** : 複雑な多段階計画のためのツール調整を提供します
- **+ トークン効率**: 圧縮通信による最適なツール選択
- **複雑なタスク**: インテリジェントなツールルーティングを追加して実行を強化
---
### ⚡ トークン効率モード - 圧縮通信
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-token-efficiency-mode---compressed-communication)
**目的**: 情報の品質を維持しながら、シンボル システムを通じて推定 30 50% のトークン削減を実現します。
**自動アクティベーショントリガー:**
- 高いコンテキストの使用が限界に近づいています
- 資源効率が求められる大規模運用
- ユーザー明示フラグ: `--uc``--ultracompressed`
- 複数の出力を持つ複雑な分析ワークフロー
**行動の変化:**
- **シンボルコミュニケーション**: ロジックフロー、ステータス、技術ドメインに視覚的なシンボルを使用します
- **技術略語**:繰り返される技術用語のコンテキスト認識圧縮
- **構造化された密度**: 冗長な段落よりも箇条書き、表、簡潔な書式
- **情報保存**: 圧縮しても95%以上の情報品質を維持
- **構造化されたフォーマット**: 明確さとタスクの完了のために整理されています
**経験例:**
```
Standard Approach: "The authentication system implementation shows a security vulnerability in the user validation function that needs immediate attention..."
Token Efficient Approach:
"🛡️ Security Alert:
auth.js:45 → user val() → critical vuln
📊 Impact: ❌ token bypass possible
⚡ Action: fix validation + audit ∵ high sev
🔧 Est: 2h impl + 1h test"
```
**最適な組み合わせ:**
- **任意のモード**: モード固有の動作を維持しながら圧縮レイヤーを追加します
- **オーケストレーション →** : 圧縮されたツール調整とステータス更新
- **手動オーバーライド**:`--uc`コンテキストのプレッシャーや効率が優先される場合に使用します
---
### 🎨 標準モード - バランスのとれたデフォルト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#-standard-mode---balanced-default)
**目的**: 簡単な開発タスクに対して明確でプロフェッショナルなコミュニケーションを提供します。
**自動アクティベーショントリガー:**
- 複雑さの指標のない、シンプルで明確に定義されたタスク
- 明確な要件を備えた単一ファイル操作
- 基本的な説明と標準的な開発ワークフロー
- 他のモードトリガーは検出されません(デフォルトのフォールバック)
**行動の変化:**
- **プロフェッショナルなコミュニケーション**:明確で簡潔な技術用語
- **中程度の詳細**: ほとんどの開発タスクに適したバランスの取れた情報の深さ
- **標準ツール選択**: ネイティブのClaude機能と基本ツールを使用
- **品質重視**: 複雑なオーケストレーションのオーバーヘッドなしでコードの品質を維持
- **応答的な適応**:複雑さが増すと、特化したモードに切り替える準備ができています
**経験例:**
```
Standard Approach: Consistent, professional baseline for all tasks
"I'll implement the login function with proper error handling:
1. Validate user input (email format, password requirements)
2. Authenticate against database with secure hashing
3. Generate JWT token with appropriate expiration
4. Return success response with user data
The implementation will follow security best practices and include comprehensive error handling."
```
**最適な組み合わせ:**
- **→ 任意のモード**: 他のモードを強化する基準として機能します
- **モード切り替え**: 必要に応じて自動的に特殊モードに切り替えます
- **明確さの優先**: 最適化よりも分かりやすいコミュニケーションが重要な場合
---
## 高度な使用法
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#advanced-usage)
### モードの組み合わせ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-combinations)
**マルチモードワークフロー:**
```shell
# Discovery → Planning → Implementation
/sc:brainstorm "microservices architecture" --task-manage
# → Brainstorming: requirement discovery
# → Task Management: multi-phase coordination
# Analysis with transparency and efficiency
/sc:analyze legacy-system/ --introspect --uc
# → Introspection: transparent reasoning
# → Token Efficiency: compressed output
```
### 手動モード制御
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#manual-mode-control)
**特定の動作を強制する:**
- `--brainstorm`: あらゆるタスクで共同発見を強制
- `--introspect`: あらゆるモードに推論の透明性を追加
- `--task-manage`: 階層的な調整を可能にする
- `--orchestrate`: ツール選択と並列実行を最適化
- `--uc`: 効率化のために通信を圧縮する
**オーバーライドの例:**
```shell
# Force brainstorming on "clear" requirements
/sc:implement "user login" --brainstorm
# Add reasoning transparency to debugging
/sc:fix auth-issue --introspect
# Enable task management for simple operations
/sc:update styles.css --task-manage
```
### モードの境界と優先順位
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-boundaries-and-priority)
**モードがアクティブになると:**
1. **複雑さの閾値**: >3ファイル → タスク管理
2. **リソースの圧力**:コンテキスト使用率が高い → トークン効率
3. **複数のツールが必要**: 複雑な分析 → オーケストレーション
4. **不確実性**:漠然とした要件 → ブレインストーミング
5. **エラー回復**:問題 → イントロスペクション
**優先ルール:**
- **安全第一**:品質と検証は常に効率よりも優先されます
- **ユーザーの意図**: 手動フラグは自動検出を上書きします
- **コンテキスト適応**: 複雑さに基づいてモードをスタック
- **リソース管理**:プレッシャー下では効率モードが活性化する
---
## 実世界の例
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#real-world-examples)
### 完全なワークフローの例
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#complete-workflow-examples)
**新規プロジェクト開発:**
```shell
# Phase 1: Discovery (Brainstorming Mode auto-activates)
"I want to build a productivity app"
→ 🤔 Socratic questions about users, features, platform choice
→ 📝 Structured requirements brief
# Phase 2: Planning (Task Management Mode auto-activates)
/sc:implement "core productivity features"
→ 📋 Multi-phase breakdown with dependencies
→ 🎯 Phase coordination with quality gates
# Phase 3: Implementation (Orchestration Mode coordinates tools)
/sc:develop frontend + backend
→ 🎯 Magic (UI) + Context7 (patterns) + Sequential (architecture)
→ ⚡ Parallel execution optimization
```
**複雑な問題のデバッグ:**
```shell
# Problem analysis (Introspection Mode auto-activates)
"Users getting intermittent auth failures"
→ 🤔 Transparent reasoning about potential causes
→ 🎯 Hypothesis formation and evidence gathering
→ 💡 Pattern recognition across similar issues
# Systematic resolution (Task Management coordinates)
/sc:fix auth-system --comprehensive
→ 📋 Phase 1: Root cause analysis
→ 📋 Phase 2: Solution implementation
→ 📋 Phase 3: Testing and validation
```
### モードの組み合わせパターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-combination-patterns)
**非常に複雑なシナリオ:**
```shell
# Large refactoring with multiple constraints
/sc:modernize legacy-system/ --introspect --uc --orchestrate
→ 🔍 Transparent reasoning (Introspection)
→ ⚡ Compressed communication (Token Efficiency)
→ 🎯 Optimal tool coordination (Orchestration)
→ 📋 Systematic phases (Task Management auto-activates)
```
---
## クイックリファレンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#quick-reference)
### モード起動パターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-activation-patterns)
|トリガータイプ|入力例|モードが有効|主要な動作|
|---|---|---|---|
|**漠然とした要求**|「アプリを作りたい」|🧠 ブレインストーミング|ソクラテス式の発見的質問|
|**複雑なスコープ**|>3 つのファイルまたは >2 つのディレクトリ|📋 タスク管理|位相調整|
|**マルチツールの必要性**|分析 + 実装|🎯 オーケストレーション|ツールの最適化|
|**エラー回復**|「期待通りに動作していません」|🔍 内省|透明な推論|
|**リソースの圧力**|高コンテキスト使用|⚡ トークン効率|シンボル圧縮|
|**簡単なタスク**|「この機能を修正する」|🎨 標準|明確で直接的なアプローチ|
### 手動オーバーライドコマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#manual-override-commands)
```shell
# Force specific mode behaviors
/sc:command --brainstorm # Collaborative discovery
/sc:command --introspect # Reasoning transparency
/sc:command --task-manage # Hierarchical coordination
/sc:command --orchestrate # Tool optimization
/sc:command --uc # Token compression
# Combine multiple modes
/sc:command --introspect --uc # Transparent + efficient
/sc:command --task-manage --orchestrate # Coordinated + optimized
```
---
## トラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#troubleshooting)
トラブルシューティングのヘルプについては、以下を参照してください。
- [よくある問題](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)- よくある問題に対するクイック修正
- [トラブルシューティングガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/troubleshooting.md)- 包括的な問題解決
### よくある問題
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#common-issues)
- **モードがアクティブ化されていません**: 手動フラグを使用してください: `--brainstorm`、、`--introspect``--uc`
- **間違ったモードがアクティブです**: リクエスト内の複雑なトリガーとキーワードを確認してください
- **予期しないモード切り替え**:タスクの進行に基づく通常の動作
- **実行への影響**: モードはツールの使用を最適化するものであり、実行には影響しないはずです。
- **モードの競合**:[フラグガイドでフラグの優先順位ルールを確認してください](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)
### 即時修正
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#immediate-fixes)
- **特定のモードを強制**:`--brainstorm`またはのような明示的なフラグを使用する`--task-manage`
- **リセットモードの動作**: モード状態をリセットするには、Claude Code セッションを再起動します。
- **モードインジケーターを確認する**: 応答に🤔、🎯、📋の記号があるかどうかを確認します
- **複雑さを検証**: 単純なタスクは標準モードを使用し、複雑なタスクは自動的に切り替わります
### モード固有のトラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#mode-specific-troubleshooting)
**ブレインストーミングモードの問題:**
```shell
# Problem: Mode gives solutions instead of asking questions
# Quick Fix: Check request clarity and use explicit flag
/sc:brainstorm "web app" --brainstorm # Force discovery mode
"I have a vague idea about..." # Use uncertainty language
"Maybe we could build..." # Trigger exploration
```
**タスク管理モードの問題:**
```shell
# Problem: Simple tasks getting complex coordination
# Quick Fix: Reduce scope or use simpler commands
/sc:implement "function" --no-task-manage # Disable coordination
/sc:simple-fix bug.js # Use basic commands
# Check if task really is complex (>3 files, >2 directories)
```
**トークン効率モードの問題:**
```shell
# Problem: Output too compressed or unclear
# Quick Fix: Disable compression for clarity
/sc:command --no-uc # Disable compression
/sc:command --verbose # Force detailed output
# Use when clarity is more important than efficiency
```
**イントロスペクションモードの問題:**
```shell
# Problem: Too much meta-commentary, not enough action
# Quick Fix: Disable introspection for direct work
/sc:command --no-introspect # Direct execution
# Use introspection only for learning and debugging
```
**オーケストレーション モードの問題:**
```shell
# Problem: Tool coordination causing confusion
# Quick Fix: Simplify tool usage
/sc:command --no-mcp # Native tools only
/sc:command --simple # Basic execution
# Check if task complexity justifies orchestration
```
### エラーコードリファレンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#error-code-reference)
|モードエラー|意味|クイックフィックス|
|---|---|---|
|**B001**|ブレインストーミングが起動できませんでした|`--brainstorm`明示的なフラグを使用する|
|**T001**|タスク管理のオーバーヘッド|`--no-task-manage`簡単なタスクに使用する|
|**U001**|トークン効率が強すぎる|使用`--verbose`または`--no-uc`|
|**I001**|イントロスペクションモードが停止しました|`--no-introspect`直接行動に使う|
|**O001**|オーケストレーション調整に失敗|使用`--no-mcp`または`--simple`|
|**M001**|モードの競合が検出されました|フラグの優先順位のルールを確認する|
|**M002**|モード切り替えループ|状態をリセットするにはセッションを再起動してください|
|**M003**|モードが認識されません|SuperClaudeを更新するかスペルをチェックする|
### プログレッシブサポートレベル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#progressive-support-levels)
**レベル 1: クイックフィックス (< 2 分)**
- 自動モード選択を無効にするには手動フラグを使用します
- タスクの複雑さが期待されるモードの動作と一致しているかどうかを確認する
- Claude Codeセッションを再起動してみてください
**レベル2: 詳細なヘルプ515分**
```shell
# Mode-specific diagnostics
/sc:help modes # List all available modes
/sc:reflect --type mode-status # Check current mode state
# Review request complexity and triggers
```
- モードのインストールに関する問題については、[一般的な問題ガイドを](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)参照してください。
**レベル3: 専門家によるサポート30分以上**
```shell
# Deep mode analysis
SuperClaude install --diagnose
# Check mode activation patterns
# Review behavioral triggers and thresholds
```
- 行動モード分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/diagnostic-reference.md)を参照してください
**レベル4: コミュニティサポート**
- [GitHub Issues](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)でのモードの問題の報告[](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues)
- 予期しないモード動作の例を含める
- 望ましいモードと実際のモードのアクティベーションを説明する
### 成功の検証
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#success-validation)
モード修正を適用した後、次のようにテストします。
- [ ] シンプルなリクエストには標準モード(明確で直接的な応答)を使用します
- [ ] 複雑な要求は適切なモード(調整、推論)を自動的にアクティブ化します
- [ ] 手動フラグは自動検出を正しく上書きします
- [ ] モードインジケーター(🤔、🎯、📋)は予想通りに表示されます
- [ ] さまざまなモードでパフォーマンスは良好です
## クイックトラブルシューティング(レガシー)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#quick-troubleshooting-legacy)
- **モードがアクティブ化されない**→手動フラグを使用: `--brainstorm`、、`--introspect``--uc`
- **間違ったモードがアクティブです**→ リクエスト内の複雑なトリガーとキーワードを確認してください
- **予期せぬモード切り替え**→ タスクの進行に基づく通常の動作
- **実行への影響**→ モードはツールの使用を最適化するものであり、実行には影響しないはずです
- **モードの競合→**[フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)でフラグの優先順位ルールを確認してください[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)
## よくある質問
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#frequently-asked-questions)
**Q: どのモードがアクティブになっているかはどうすればわかりますか?** A: 通信パターンで次のインジケーターを確認してください。
- 🤔発見の質問 → ブレインストーミング
- 🎯 推論の透明性 → 内省
- フェーズの内訳 → タスク管理
- ツール調整 → オーケストレーション
- シンボル圧縮 → トークン効率
**Q: 特定のモードを強制できますか?** A: はい、手動フラグを使用して自動検出をオーバーライドします。
```shell
/sc:command --brainstorm # Force discovery
/sc:command --introspect # Add transparency
/sc:command --task-manage # Enable coordination
/sc:command --uc # Compress output
```
**Q: モードは実行に影響しますか?** A: モードは調整を通じてツールの使用を最適化します。
- **トークン効率**: 3050%のコンテキスト削減
- **オーケストレーション**:並列処理
- **タスク管理**:体系的な計画を通じて手戻りを防止
**Q: モードは連携して動作しますか?** A: はい、モードは互いに補完し合うように設計されています。
- **タスク管理は**他のモードを調整します
- **トークン効率は**あらゆるモードの出力を圧縮する
- **イントロスペクションは**あらゆるワークフローに透明性をもたらします
---
## まとめ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#summary)
SuperClaude の 5 つの行動モードは、ユーザーのニーズに自動的に適合する**インテリジェントな適応システムを作成します。**
- **🧠 ブレインストーミング**:漠然としたアイデアを明確な要件に変換する
- **🔍 イントロスペクション**:学習とデバッグのための透過的な推論を提供します
- **📋 タスク管理**:複雑な複数ステップの操作を調整します
- **🎯 オーケストレーション**: ツールの選択と並列実行を最適化します
- **⚡ トークン効率**: 明瞭さを保ちながらコミュニケーションを圧縮する
- **🎨 標準**: 単純なタスクに対してプロフェッショナルな基準を維持します
**重要な洞察**モードについて考える必要はありません。モードは透過的に動作し、開発エクスペリエンスを向上させます。達成したいことを説明するだけで、SuperClaudeはニーズに合わせてアプローチを自動的に調整します。
---
## 関連ガイド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md#related-guides)
**学習の進捗:**
**🌱 エッセンシャル第1週**
- [クイックスタートガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)- モードの有効化例
- [コマンドリファレンス](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)- コマンドは自動的にモードをアクティブ化します
- [インストールガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md)- 動作モードの設定
**🌿中級第23週**
- [エージェントガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md)- モードとスペシャリストの連携方法
- [フラグガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/flags.md)- 手動モードの制御と最適化
- [例文集](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)- モードパターンの実践
**🌲 上級2ヶ月目以降**
- [MCP サーバー](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)- 拡張機能を備えたモード統合
- [セッション管理](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)- タスク管理モードのワークフロー
- [はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)- モードの使用パターン
**🔧 エキスパート**
- [技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/technical-architecture.md)- モード実装の詳細
- [コードの貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/contributing-code.md)- モードの機能を拡張する
**モード固有のガイド:**
- **ブレインストーミング**[要件発見パターン](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md#requirements)
- **タスク管理**[セッション管理ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md)
- **オーケストレーション**: [MCP サーバー ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/mcp-servers.md)
- **トークン効率**[コマンドの基礎](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md#token-efficiency)

View File

@@ -0,0 +1,414 @@
# セッション管理ガイド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-management-guide)
SuperClaude は、Serena MCP サーバーを通じて永続的なセッション管理を提供し、Claude Code の会話全体にわたる真のコンテキスト保存と長期的なプロジェクト継続性を実現します。
## 永続メモリを使用したコアセッションコマンド
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#core-session-commands-with-persistent-memory)
### `/sc:load`- 永続メモリによるコンテキストの読み込み
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#scload---context-loading-with-persistent-memory)
**目的**: 以前のセッションからのプロジェクトコンテキストと永続メモリを使用してセッションを初期化します。MCP
**統合**: Serena MCP をトリガーして、保存されたプロジェクトメモリを読み取ります。
**構文**:`/sc:load [project_path]`
**何が起こるのですか**
- Serena MCPは以前のセッションから永続メモリファイルを読み取ります
- プロジェクトのコンテキストは保存されたメモリから復元されます
- 過去の決定、パターン、進捗状況が読み込まれます
- セッション状態は履歴コンテキストで初期化されます
**ユースケース**:
```shell
# Load existing project context from persistent memory
/sc:load src/
# Resume specific project work with full history
/sc:load "authentication-system"
# Initialize with codebase analysis and previous insights
/sc:load . --analyze
```
### `/sc:save`- メモリへのセッションの永続性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#scsave---session-persistence-to-memory)
**目的**: 現在のセッション状態と決定を永続メモリ
**MCP に保存します。統合**: Serena MCP をトリガーしてメモリ ファイルに書き込みます。
**構文**:`/sc:save "session_description"`
**何が起こるのですか**
- 現在の状況と決定はセレナのメモリに書き込まれます
- プロジェクトの状態と進捗は会話を通じて維持されます
- 重要な洞察とパターンは将来のセッションのために保存されます
- セッション概要はタイムスタンプ付きで作成され、検索に利用できます
**ユースケース**:
```shell
# Save completed feature work for future reference
/sc:save "user authentication implemented with JWT"
# Checkpoint during complex work
/sc:save "API design phase complete, ready for implementation"
# Store architectural decisions permanently
/sc:save "microservices architecture decided, service boundaries defined"
```
### `/sc:reflect`- メモリコンテキストによる進捗状況の評価
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#screflect---progress-assessment-with-memory-context)
**目的**: 保存されたメモリに対して現在の進行状況を分析し、セッションの完全性を検証する
**MCP 統合**: Serena MCP を使用して、保存されたメモリと現在の状態を比較する
**構文**:`/sc:reflect [--scope project|session]`
**何が起こるのですか**
- セレナMCPは過去の記憶と現在の文脈を読み取ります
- 進捗は保存された目標とマイルストーンに対して評価されます
- 歴史的背景に基づいてギャップと次のステップが特定される
- セッションの完全性はプロジェクトメモリに対して検証されます
**ユースケース**:
```shell
# Assess project progress against stored milestones
/sc:reflect --scope project
# Validate current session completeness
/sc:reflect
# Check if ready to move to next phase based on memory
/sc:reflect --scope session
```
## 永続メモリアーキテクチャ
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#persistent-memory-architecture)
### Serena MCP が真の永続性を実現する方法
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#how-serena-mcp-enables-true-persistence)
**メモリストレージ**:
- 構造化メモリファイルとして保存されるセッションコンテキスト
- プロジェクトの決定とアーキテクチャパターンは永久に保存されます
- コード分​​析の結果と洞察は会話を通じて保持されます
- 進捗状況の追跡とマイルストーンのデータは長期にわたって維持されます
**セッション間の継続性**:
- 以前のセッションのコンテキストが新しい会話で自動的に利用可能
- 決定と根拠は会話を通じて保存され、アクセス可能
- 過去のパターンと解決策からの学習を維持
- 一貫したプロジェクト理解が永久に維持される
**メモリタイプ**:
- **プロジェクトの思い出**:長期プロジェクトの文脈とアーキテクチャ
- **セッションの記憶**:具体的な会話の結果と決定
- **パターンメモリ**:再利用可能なソリューションとアーキテクチャパターン
- **進捗の思い出**:マイルストーンの追跡と完了ステータス
## 永続性を備えたセッションライフサイクルパターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-lifecycle-patterns-with-persistence)
### 新しいプロジェクトの初期化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#new-project-initialization)
```shell
# 1. Start fresh project
/sc:brainstorm "e-commerce platform requirements"
# 2. Save initial decisions to persistent memory
/sc:save "project scope and requirements defined"
# 3. Begin implementation planning
/sc:workflow "user authentication system"
# 4. Save architectural decisions permanently
/sc:save "auth architecture: JWT + refresh tokens + rate limiting"
```
### 既存の作業の再開(クロス会話)
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#resuming-existing-work-cross-conversation)
```shell
# 1. Load previous context from persistent memory
/sc:load "e-commerce-project"
# 2. Assess current state against stored progress
/sc:reflect --scope project
# 3. Continue with next phase using stored context
/sc:implement "payment processing integration"
# 4. Save progress checkpoint to memory
/sc:save "payment system integrated with Stripe API"
```
### 長期プロジェクト管理
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#long-term-project-management)
```shell
# Weekly checkpoint pattern with persistence
/sc:load project-name
/sc:reflect --scope project
# ... work on features ...
/sc:save "week N progress: features X, Y, Z completed"
# Phase completion pattern with memory
/sc:reflect --scope project
/sc:save "Phase 1 complete: core authentication and user management"
/sc:workflow "Phase 2: payment and order processing"
```
## クロス会話の継続性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#cross-conversation-continuity)
### 粘り強く新しい会話を始める
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#starting-new-conversations-with-persistence)
新しい Claude Code 会話を開始すると、永続メモリ システムによって次のことが可能になります。
1. **自動コンテキスト復元**
```shell
/sc:load project-name
# Automatically restores all previous context, decisions, and progress
```
2. **進歩の継続**
- 以前のセッションの決定はすぐに利用可能
- アーキテクチャパターンとコードの洞察は保存されます
- プロジェクトの履歴と根拠が維持される
3. **インテリジェントなコンテキスト構築**
- Serena MCPは、現在の作業に基づいて関連するメモリを提供します
- 過去のソリューションとパターンが新しい実装に影響を与える
- プロジェクトの進捗状況が追跡され、理解される
### メモリ最適化
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#memory-optimization)
**有効なメモリ使用量**:
- 説明的かつ検索可能なメモリ名を使用する
- プロジェクトのフェーズとタイムスタンプのコンテキストを含める
- 特定の機能やアーキテクチャ上の決定を参照する
- 将来の検索を直感的にする
**記憶内容戦略**
- 結果だけでなく、意思決定と根拠も保存する
- 検討した代替アプローチを含める
- 統合パターンと依存関係を文書化する
- 学習内容と洞察を将来の参考のために保存する
**メモリライフサイクル管理**:
- 古くなったメモリの定期的なクリーンアップ
- 関連するセッション記憶の統合
- 完了したプロジェクトフェーズのアーカイブ
- 時代遅れのアーキテクチャ上の決定の削減
## 永続セッションのベストプラクティス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#best-practices-for-persistent-sessions)
### セッション開始プロトコル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-start-protocol)
1. `/sc:load`既存のプロジェクトの場合は常に
2. `/sc:reflect`記憶から現在の状態を理解するために使用する
3. 永続的なコンテキストと保存されたパターンに基づいて作業を計画する
4. 過去の決定とアーキテクチャの選択に基づいて構築する
### セッション終了プロトコル
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#session-end-protocol)
1. `/sc:reflect`保存された目標に対する完全性を評価するために使用します
2. 重要な決定を`/sc:save`将来のセッションのために保存する
3. 次のステップと未解決の質問を記憶に記録する
4. 将来のシームレスな継続のためにコンテキストを保存する
### 記憶品質の維持
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#memory-quality-maintenance)
- 簡単に思い出せるように、分かりやすく説明的なメモリ名を使用する
- 決定事項と代替アプローチに関する背景情報を含める
- 特定のコードの場所とパターンを参照する
- セッション間でメモリ構造の一貫性を維持する
## 他のSuperClaude機能との統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#integration-with-other-superclaude-features)
### MCP サーバー調整
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#mcp-server-coordination)
- **Serena MCP** : 永続メモリインフラストラクチャを提供します
- **シーケンシャルMCP** : 保存されたメモリを使用して複雑な分析を強化します
- **Context7 MCP** : 保存されたパターンとドキュメント化のアプローチを参照します
- **Morphllm MCP** : 保存されたリファクタリングパターンを一貫して適用します
### エージェントとメモリの連携
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#agent-collaboration-with-memory)
- エージェントは強化されたコンテキストのために永続的なメモリにアクセスします
- 以前の専門家の決定は保存され、参照されます
- 共有メモリを介したセッション間エージェント調整
- プロジェクトの履歴に基づいた一貫した専門家の推奨
### 永続性を備えたコマンド統合
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#command-integration-with-persistence)
- すべての`/sc:`コマンドは永続的なコンテキストを参照し、そのコンテキストに基づいて構築できます。
- 以前のコマンド出力と決定はセッション間で利用可能
- ワークフローパターンは保存され、再利用できる
- 実装履歴は将来の指揮決定を導く
## 永続セッションのトラブルシューティング
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#troubleshooting-persistent-sessions)
### よくある問題
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#common-issues)
**メモリが読み込まれません**:
- Serena MCP が正しく構成され、実行されていることを確認します。
- メモリファイルの権限とアクセス可能性を確認する
- プロジェクトの命名規則の一貫性を確保する
- メモリファイルの整合性とフォーマットを検証する
**セッション間のコンテキスト損失**:
- `/sc:save`セッションを終了する前に必ず使用してください
- 簡単に検索できるように、わかりやすいメモリ名を使用する
- メモリの完全性を定期的`/sc:reflect`に検証する
- 重要なメモリファイルを定期的にバックアップする
**メモリの競合**:
- バージョン管理にはタイムスタンプ付きのメモリ名を使用する
- 古くなった記憶の定期的なクリーンアップ
- プロジェクトとセッションのメモリを明確に分離
- セッション間で一貫したメモリ命名規則
### クイックフィックス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#quick-fixes)
**セッション状態をリセット**:
```shell
/sc:load --fresh # Start without previous context
/sc:reflect # Assess current state
```
**メモリクリーンアップ**:
```shell
/sc:reflect --cleanup # Remove obsolete memories
/sc:save --consolidate # Merge related memories
```
**コンテキスト回復**:
```shell
/sc:load --recent # Load most recent memories
/sc:reflect --repair # Identify and fix context gaps
```
## 高度な永続セッションパターン
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#advanced-persistent-session-patterns)
### 複数フェーズのプロジェクト
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#multi-phase-projects)
- 整理のためにフェーズ固有のメモリ命名を使用する
- フェーズ全体でアーキテクチャ上の決定の継続性を維持する
- 永続メモリによるクロスフェーズ依存関係の追跡
- 歴史的背景を考慮した漸進的な複雑性管理
### チームコラボレーション
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#team-collaboration)
- 共有メモリの規則と命名規則
- チームのコンテキストにおける意思決定根拠の保存
- すべてのチームメンバーがアクセスできる統合パターンのドキュメント
- メモリを介した一貫したコードスタイルとアーキテクチャの適用
### 長期メンテナンス
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#long-term-maintenance)
- 完了したプロジェクトのメモリアーカイブ戦略
- 蓄積された記憶によるパターンライブラリの開発
- 時間をかけて構築された再利用可能なソリューションドキュメント
- 永続的なメモリ蓄積による知識ベースの構築
## 永続セッション管理の主な利点
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#key-benefits-of-persistent-session-management)
### プロジェクトの継続性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#project-continuity)
- 複数の会話にわたるシームレスな作業継続
- Claude Codeセッション間でコンテキストが失われることはありません
- 保存されたアーキテクチャ上の決定と技術的根拠
- 長期的なプロジェクトの進捗追跡
### 生産性の向上
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#enhanced-productivity)
- プロジェクトのコンテキストを再度説明する必要性が減少
- 起動時間が速く、作業を継続できる
- 過去の洞察とパターンに基づいて
- 累積的なプロジェクト知識の成長
### 品質の一貫性
[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/session-management.md#quality-consistency)
- セッション間で一貫したアーキテクチャパターン
- コード品質の決定と標準の保持
- 再利用可能なソリューションとベストプラクティス
- 技術的負債の認識を維持
---
**重要なポイント**: Serena MCP によるセッション管理により、SuperClaude は単一の会話の支援から永続的なプロジェクト パートナーシップへと変わり、すべての開発フェーズと Claude Code の会話にわたってコンテキスト、決定、学習が維持されます。