diff --git a/Docs/User-Guide-jp/agents.md b/Docs/User-Guide-jp/agents.md new file mode 100644 index 0000000..8a10080 --- /dev/null +++ b/Docs/User-Guide-jp/agents.md @@ -0,0 +1,1029 @@ +# SuperClaude エージェントガイド 🤖 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#superclaude-agents-guide-) + +SuperClaude は、Claude Code が専門知識を得るために呼び出すことができる 14 のドメイン スペシャリスト エージェントを提供します。 + +## 🧪 エージェントのアクティベーションのテスト + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#-testing-agent-activation) + +このガイドを使用する前に、エージェントの選択が機能することを確認してください。 + +```shell +# Test manual agent invocation +@agent-python-expert "explain decorators" +# Example behavior: Python expert responds with detailed explanation + +# Test security agent auto-activation +/sc:implement "JWT authentication" +# Example behavior: Security engineer should activate automatically + +# Test frontend agent auto-activation +/sc:implement "responsive navigation component" +# Example behavior: Frontend architect + Magic MCP should activate + +# Test systematic analysis +/sc:troubleshoot "slow API performance" +# Example behavior: Root-cause analyst + performance engineer activation + +# Test combining manual and auto +/sc:analyze src/ +@agent-refactoring-expert "suggest improvements" +# Example behavior: Analysis followed by refactoring suggestions +``` + +**テストが失敗した場合**: エージェントファイルが存在する`~/.claude/agents/`か、Claude Codeセッションを再起動してください。 + +## コアコンセプト + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#core-concepts) + +### SuperClaude エージェントとは何ですか? + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#what-are-superclaude-agents) + +**エージェントは**、Claude Codeの行動を変更するコンテキスト指示として実装された、専門分野のAIドメインエキスパートです。各エージェントは、ドメイン固有の専門知識、行動パターン、問題解決アプローチを含む、ディレクトリ`.md`内に綿密に作成されたファイルです`SuperClaude/Agents/`。 + +**重要**: エージェントは別個の AI モデルやソフトウェアではなく、Claude Code が読み取って特殊な動作を採用するコンテキスト構成です。 + +### エージェントの2つの使用方法 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#two-ways-to-use-agents) + +#### 1. @agent- プレフィックスを使用した手動呼び出し + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#1-manual-invocation-with-agent--prefix) + +```shell +# Directly invoke a specific agent +@agent-security "review authentication implementation" +@agent-frontend "design responsive navigation" +@agent-architect "plan microservices migration" +``` + +#### 2. 自動アクティベーション（行動ルーティング） + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#2-auto-activation-behavioral-routing) + +「自動アクティベーション」とは、Claude Codeがリクエスト内のキーワードとパターンに基づいて適切なコンテキストで動作指示を読み取り、エンゲージすることを意味します。SuperClaudeは、Claudeが最適なスペシャリストにルーティングするための動作ガイドラインを提供します。 + +> **📝 エージェントの「自動アクティベーション」の仕組み**：エージェントのアクティベーションは自動システムロジックではなく、コンテキストファイル内の動作指示です。ドキュメントでエージェントが「自動アクティベート」と記載されている場合、それはClaude Codeが指示を読み取り、リクエスト内のキーワードとパターンに基づいて特定のドメインの専門知識を活用することを意味します。これにより、基盤となるメカニズムを透明化しながら、インテリジェントなルーティング体験を実現します。 + +```shell +# These commands auto-activate relevant agents +/sc:implement "JWT authentication" # → security-engineer auto-activates +/sc:design "React dashboard" # → frontend-architect auto-activates +/sc:troubleshoot "memory leak" # → performance-engineer auto-activates +``` + +**MCP サーバーは**、Context7 (ドキュメント作成)、Sequential (分析)、Magic (UI)、Playwright (テスト)、Morphllm (コード変換) などの専用ツールを通じて拡張機能を提供します。 + +**ドメイン スペシャリストは、**狭い専門分野に焦点を絞り、ジェネラリストのアプローチよりも深く正確なソリューションを提供します。 + +### エージェント選択ルール + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-selection-rules) + +**優先順位の階層:** + +1. **手動オーバーライド**- @agent-[name] は自動アクティベーションよりも優先されます +2. **キーワード**- 直接的なドメイン用語は主要なエージェントをトリガーします +3. **ファイルタイプ**- 拡張子は言語/フレームワークの専門家を活性化します +4. **複雑性**- 複数ステップのタスクには調整エージェントが関与する +5. **コンテキスト**- 関連概念は補完的なエージェントをトリガーします + +**紛争解決:** + +- 手動呼び出し → 指定したエージェントが優先されます +- 複数のマッチング → マルチエージェントコーディネーション +- 不明瞭なコンテキスト → 要件アナリストの活性化 +- 複雑性が高い → システムアーキテクトの監視 +- 品質に関する懸念 → 自動QAエージェントの組み込み + +**選択決定ツリー:** + +``` +Task Analysis → +├─ Manual @agent-? → Use specified agent +├─ Single Domain? → Activate primary agent +├─ Multi-Domain? → Coordinate specialist agents +├─ Complex System? → Add system-architect oversight +├─ Quality Critical? → Include security + performance + quality agents +└─ Learning Focus? → Add learning-guide + technical-writer +``` + +## クイックスタートの例 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quick-start-examples) + +### 手動エージェント呼び出し + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#manual-agent-invocation) + +```shell +# Explicitly call specific agents with @agent- prefix +@agent-python-expert "optimize this data processing pipeline" +@agent-quality-engineer "create comprehensive test suite" +@agent-technical-writer "document this API with examples" +@agent-socratic-mentor "explain this design pattern" +``` + +### 自動エージェント調整 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#automatic-agent-coordination) + +```shell +# Commands that trigger auto-activation +/sc:implement "JWT authentication with rate limiting" +# → Triggers: security-engineer + backend-architect + quality-engineer + +/sc:design "accessible React dashboard with documentation" +# → Triggers: frontend-architect + learning-guide + technical-writer + +/sc:troubleshoot "slow deployment pipeline with intermittent failures" +# → Triggers: devops-architect + performance-engineer + root-cause-analyst + +/sc:audit "payment processing security vulnerabilities" +# → Triggers: security-engineer + quality-engineer + refactoring-expert +``` + +### 手動と自動のアプローチを組み合わせる + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#combining-manual-and-auto-approaches) + +```shell +# Start with command (auto-activation) +/sc:implement "user profile system" + +# Then explicitly add specialist review +@agent-security "review the profile system for OWASP compliance" +@agent-performance-engineer "optimize database queries" +``` + +--- + +## SuperClaude エージェントチーム 👥 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#the-superclaude-agent-team-) + +### アーキテクチャとシステム設計エージェント 🏗️ + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#architecture--system-design-agents-%EF%B8%8F) + +### システムアーキテクト 🏢 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#system-architect-) + +**専門分野**：スケーラビリティとサービスアーキテクチャに重点を置いた大規模分散システム設計 + +**自動アクティベーション**: + +- キーワード: 「アーキテクチャ」、「マイクロサービス」、「スケーラビリティ」、「システム設計」、「分散」 +- コンテキスト: マルチサービスシステム、アーキテクチャ上の決定、テクノロジーの選択 +- 複雑さ: 5 つ以上のコンポーネントまたはドメイン間統合要件 + +**機能**: + +- サービス境界の定義とマイクロサービスの分解 +- テクノロジースタックの選択と統合戦略 +- スケーラビリティ計画とパフォーマンスアーキテクチャ +- イベント駆動型アーキテクチャとメッセージングパターン +- データフロー設計とシステム統合 + +**例**: + +1. **Eコマースプラットフォーム**：イベントソーシングを使用して、ユーザー、製品、支払い、通知サービスのマイクロサービスを設計します。 +2. **リアルタイム分析**：ストリーム処理と時系列ストレージによる高スループットデータ取り込みのためのアーキテクチャ +3. **マルチテナント SaaS** : テナント分離、共有インフラストラクチャ、水平スケーリング戦略を備えたシステム設計 + +### 成功基準 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#success-criteria) + +- [ ] 応答に表れたシステムレベルの思考 +- [ ] サービスの境界と統合パターンについて言及する +- [ ] スケーラビリティと信頼性の考慮を含む +- [ ] テクノロジースタックの推奨事項を提供する + +**検証:** `/sc:design "microservices platform"`システム アーキテクトをアクティブ化する必要があります。 +**テスト:**出力には、サービスの分解と統合パターンが含まれている必要があります。 +**チェック:**インフラストラクチャに関する懸念事項については、DevOps アーキテクトと調整する必要があります。 + +**最適な組み合わせ**: devops-architect (インフラストラクチャ)、performance-engineer (最適化)、security-engineer (コンプライアンス) + +--- + +### バックエンドアーキテクト ⚙️ + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#backend-architect-%EF%B8%8F) + +**専門分野**: APIの信頼性とデータの整合性を重視した堅牢なサーバーサイドシステム設計 + +**自動アクティベーション**: + +- キーワード: 「API」、「バックエンド」、「サーバー」、「データベース」、「REST」、「GraphQL」、「エンドポイント」 +- ファイルタイプ: API仕様、サーバー構成、データベーススキーマ +- コンテキスト: サーバーサイドロジック、データの永続性、API開発 + +**機能**: + +- RESTful および GraphQL API のアーキテクチャと設計パターン +- データベーススキーマ設計とクエリ最適化戦略 +- 認証、承認、セキュリティの実装 +- エラー処理、ログ記録、監視の統合 +- キャッシュ戦略とパフォーマンスの最適化 + +**例**: + +1. **ユーザー管理 API** : ロールベースのアクセス制御とレート制限を備えた JWT 認証 +2. **支払い処理**: べき等性と監査証跡を備えた PCI 準拠のトランザクション処理 +3. **コンテンツ管理**: キャッシュ、ページネーション、リアルタイム通知を備えた RESTful API + +**最適な組み合わせ**: security-engineer (認証/セキュリティ)、performance-engineer (最適化)、quality-engineer (テスト) + +--- + +### フロントエンドアーキテクト 🎨 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#frontend-architect-) + +**専門分野**: アクセシビリティとユーザーエクスペリエンスを重視した最新の Web アプリケーション アーキテクチャ + +**自動アクティベーション**: + +- キーワード: 「UI」、「フロントエンド」、「React」、「Vue」、「Angular」、「コンポーネント」、「アクセシビリティ」、「レスポンシブ」 +- ファイルタイプ: .jsx、.vue、.ts (フロントエンド)、.css、.scss +- コンテキスト: ユーザーインターフェース開発、コンポーネント設計、クライアント側アーキテクチャ + +**機能**: + +- コンポーネントアーキテクチャと設計システムの実装 +- 状態管理パターン (Redux、Zustand、Pinia) +- アクセシビリティ準拠（WCAG 2.1）とインクルーシブデザイン +- パフォーマンスの最適化とバンドル分析 +- プログレッシブウェブアプリとモバイルファースト開発 + +**例**: + +1. **ダッシュボードインターフェース**: リアルタイム更新とレスポンシブなグリッドレイアウトによるアクセスしやすいデータ視覚化 +2. **フォーム システム**: 検証、エラー処理、アクセシビリティ機能を備えた複雑なマルチステップ フォーム +3. **デザインシステム**: 一貫したスタイルとインタラクションパターンを備えた再利用可能なコンポーネントライブラリ + +**最適な組み合わせ**: 学習ガイド (ユーザー ガイダンス)、パフォーマンス エンジニア (最適化)、品質エンジニア (テスト) + +--- + +### DevOps アーキテクト 🚀 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#devops-architect-) + +**専門分野**: 信頼性の高いソフトウェア配信のためのインフラストラクチャ自動化と展開パイプライン設計 + +**自動アクティベーション**: + +- キーワード: 「デプロイ」、「CI/CD」、「Docker」、「Kubernetes」、「インフラストラクチャ」、「監視」、「パイプライン」 +- ファイルタイプ: Dockerfile、docker-compose.yml、k8s マニフェスト、CI 構成 +- コンテキスト: 導入プロセス、インフラストラクチャ管理、自動化 + +**機能**: + +- 自動テストとデプロイメントを備えた CI/CD パイプライン設計 +- コンテナオーケストレーションとKubernetesクラスタ管理 +- Terraform とクラウド プラットフォームを使用した Infrastructure as Code +- 監視、ログ記録、および可観測性スタックの実装 +- セキュリティスキャンとコンプライアンスの自動化 + +**例**: + +1. **マイクロサービスのデプロイメント**: サービスメッシュ、自動スケーリング、ブルーグリーンリリースを備えた Kubernetes のデプロイメント +2. **マルチ環境パイプライン**: 自動テスト、セキュリティスキャン、段階的なデプロイメントを備えた GitOps ワークフロー +3. **モニタリングスタック**: メトリック、ログ、トレース、アラートシステムによる包括的な監視 + +**最適な職種**: システム アーキテクト (インフラストラクチャ計画)、セキュリティ エンジニア (コンプライアンス)、パフォーマンス エンジニア (監視) + +### 品質・分析エージェント 🔍 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quality--analysis-agents-) + +### セキュリティエンジニア 🔒 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#security-engineer-) + +**専門分野**: 脅威モデリングと脆弱性防止に重点を置いたアプリケーション セキュリティ アーキテクチャ + +**自動アクティベーション**: + +- キーワード: 「セキュリティ」、「認証」、「脆弱性」、「暗号化」、「コンプライアンス」、「OWASP」 +- コンテキスト: セキュリティレビュー、認証フロー、データ保護要件 +- リスク指標: 支払い処理、ユーザーデータ、API アクセス、規制遵守の必要性 + +**機能**: + +- 脅威モデルと攻撃対象領域分析 +- 安全な認証と認可の設計 (OAuth、JWT、SAML) +- データ暗号化戦略と鍵管理 +- 脆弱性評価と侵入テストのガイダンス +- セキュリティコンプライアンス（GDPR、HIPAA、PCI-DSS）の実装 + +**例**: + +1. **OAuth 実装**: トークンの更新とロールベースのアクセスによる安全なマルチテナント認証 +2. **API セキュリティ**: レート制限、入力検証、SQL インジェクション防止、セキュリティ ヘッダー +3. **データ保護**: 保存時/転送時の暗号化、キーローテーション、プライバシーバイデザインアーキテクチャ + +**最適な人材**: バックエンド アーキテクト (API セキュリティ)、品質エンジニア (セキュリティ テスト)、根本原因アナリスト (インシデント対応) + +--- + +### パフォーマンスエンジニア ⚡ + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#performance-engineer-) + +**専門分野**：スケーラビリティとリソース効率を重視したシステムパフォーマンスの最適化 + +**自動アクティベーション**: + +- キーワード: 「パフォーマンス」、「遅い」、「最適化」、「ボトルネック」、「レイテンシ」、「メモリ」、「CPU」 +- コンテキスト: パフォーマンスの問題、スケーラビリティの懸念、リソースの制約 +- メトリクス: 応答時間 >500 ミリ秒、メモリ使用量が多い、スループットが低い + +**機能**: + +- パフォーマンスプロファイリングとボトルネックの特定 +- データベースクエリの最適化とインデックス戦略 +- キャッシュ実装（Redis、CDN、アプリケーションレベル） +- 負荷テストと容量計画 +- メモリ管理とリソースの最適化 + +**例**: + +1. **API最適化**: キャッシュとクエリの最適化により、応答時間を2秒から200ミリ秒に短縮 +2. **データベースのスケーリング**: リードレプリカ、接続プール、クエリ結果のキャッシュを実装する +3. **フロントエンドのパフォーマンス**: バンドルの最適化、遅延読み込み、および CDN 実装により、読み込み時間が 3 秒未満に短縮されます。 + +**最適な組み合わせ**: システム アーキテクト (スケーラビリティ)、DevOps アーキテクト (インフラストラクチャ)、ルート原因アナリスト (デバッグ) + +--- + +### 根本原因分析者 🔍 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#root-cause-analyst-) + +**専門分野**：証拠に基づく分析と仮説検定を用いた体系的な問題調査 + +**自動アクティベーション**: + +- キーワード: 「バグ」、「問題」、「問題」、「デバッグ」、「調査」、「トラブルシューティング」、「エラー」 +- コンテキスト: システム障害、予期しない動作、複雑な複数コンポーネントの問題 +- 複雑性: 体系的な調査を必要とするシステム間問題 + +**機能**: + +- 体系的なデバッグ方法論と根本原因分析 +- システム間のエラー相関と依存関係のマッピング +- 障害調査のためのログ分析とパターン認識 +- 複雑な問題に対する仮説形成と検証 +- インシデント対応と事後分析手順 + +**例**: + +1. **データベース接続障害**: 接続プール、ネットワーク タイムアウト、リソース制限にわたる断続的な障害をトレースします。 +2. **支払い処理エラー**: APIログ、データベースの状態、外部サービスの応答を通じてトランザクションの失敗を調査します。 +3. **パフォーマンスの低下**: メトリクスの相関関係、リソースの使用状況、コードの変更を通じて、段階的な速度低下を分析します。 + +**最適な担当者**: パフォーマンス エンジニア (パフォーマンスの問題)、セキュリティ エンジニア (セキュリティ インシデント)、品質エンジニア (テストの失敗) + +--- + +### 品質エンジニア ✅ + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quality-engineer-) + +**専門分野**:自動化とカバレッジに重点を置いた包括的なテスト戦略と品質保証 + +**自動アクティベーション**: + +- キーワード: 「テスト」、「テスト」、「品質」、「QA」、「検証」、「カバレッジ」、「自動化」 +- コンテキスト: テスト計画、品質ゲート、検証要件 +- 品質に関する懸念: コードカバレッジ <80%、テスト自動化の欠如、品質の問題 + +**機能**: + +- テスト戦略設計（ユニット、統合、E2E、パフォーマンステスト） +- テスト自動化フレームワークの実装とCI/CD統合 +- 品質指標の定義と監視（カバレッジ、欠陥率） +- エッジケースの特定と境界テストのシナリオ +- アクセシビリティテストとコンプライアンス検証 + +**例**: + +1. **Eコマーステスト**: ユーザーフロー、支払い処理、在庫管理を網羅した包括的なテストスイート +2. **API テスト**: REST/GraphQL API の自動契約テスト、負荷テスト、セキュリティ テスト +3. **アクセシビリティ検証**：自動および手動のアクセシビリティ監査による WCAG 2.1 準拠テスト + +**最適な職種**: セキュリティ エンジニア (セキュリティ テスト)、パフォーマンス エンジニア (負荷テスト)、フロントエンド アーキテクト (UI テスト) + +--- + +### リファクタリングの専門家 🔧 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#refactoring-expert-) + +**専門分野**：体系的なリファクタリングと技術的負債管理によるコード品質の改善 + +**自動アクティベーション**: + +- キーワード: 「リファクタリング」、「クリーンコード」、「技術的負債」、「SOLID」、「保守性」、「コード臭」 +- コンテキスト: レガシーコードの改善、アーキテクチャの更新、コード品質の問題 +- 品質指標: 複雑性が高い、コードの重複がある、テスト範囲が狭い + +**機能**: + +- SOLID原則の適用と設計パターンの実装 +- コードの臭いの特定と体系的な排除 +- レガシーコードの近代化戦略と移行計画 +- 技術的負債の評価と優先順位付けのフレームワーク +- コード構造の改善とアーキテクチャのリファクタリング + +**例**: + +1. **レガシーモダナイゼーション**: テスト容易性を向上させたモノリシックアプリケーションをモジュール型アーキテクチャに変換する +2. **デザインパターン**: 支払い処理に戦略パターンを実装して結合を減らし、拡張性を向上させる +3. **コードのクリーンアップ**: 重複したコードを削除し、命名規則を改善し、再利用可能なコンポーネントを抽出します。 + +**最適な組み合わせ**: system-architect (アーキテクチャの改善)、quality-engineer (テスト戦略)、python-expert (言語固有のパターン) + +### 専門開発エージェント 🎯 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#specialized-development-agents-) + +### Python エキスパート 🐍 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#python-expert-) + +**専門分野**: 最新のフレームワークとパフォーマンスを重視した、本番環境対応の Python 開発 + +**自動アクティベーション**: + +- キーワード: 「Python」、「Django」、「FastAPI」、「Flask」、「asyncio」、「pandas」、「pytest」 +- ファイルタイプ: .py、requirements.txt、pyproject.toml、Pipfile +- コンテキスト: Python 開発タスク、API 開発、データ処理、テスト + +**機能**: + +- 最新のPythonアーキテクチャパターンとフレームワークの選択 +- asyncio と並行未来を用いた非同期プログラミング +- プロファイリングとアルゴリズムの改善によるパフォーマンスの最適化 +- pytest、フィクスチャ、テスト自動化によるテスト戦略 +- pip、poetry、Docker を使用したパッケージ管理とデプロイメント + +**例**: + +1. **FastAPI マイクロサービス**: Pydantic 検証、依存性注入、OpenAPI ドキュメントを備えた高性能非同期 API +2. **データ パイプライン**: エラー処理、ログ記録、大規模データセットの並列処理を備えた Pandas ベースの ETL +3. **Django アプリケーション**: カスタム ユーザー モデル、API エンドポイント、包括的なテスト カバレッジを備えたフルスタック Web アプリ + +**最適な職種**: バックエンド アーキテクト (API 設計)、品質エンジニア (テスト)、パフォーマンス エンジニア (最適化) + +--- + +### 要件アナリスト 📝 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#requirements-analyst-) + +**専門分野**：体系的なステークホルダー分析による要件発見と仕様策定 + +**自動アクティベーション**: + +- キーワード: 「要件」、「仕様」、「PRD」、「ユーザーストーリー」、「機能」、「スコープ」、「ステークホルダー」 +- 背景: プロジェクトの開始、不明確な要件、スコープ定義の必要性 +- 複雑さ: 複数の利害関係者が関わるプロジェクト、不明確な目標、相反する要件 + +**機能**: + +- ステークホルダーへのインタビューやワークショップを通じた要件抽出 +- 受け入れ基準と完了の定義を含むユーザーストーリーの記述 +- 機能仕様と非機能仕様のドキュメント +- ステークホルダー分析と要件優先順位付けフレームワーク +- スコープ管理と変更管理プロセス + +**例**: + +1. **製品要件ドキュメント**: ユーザー ペルソナ、機能仕様、成功指標を含む、フィンテック モバイル アプリの包括的な PRD +2. **API仕様**: エラー処理、セキュリティ、パフォーマンス基準を含む支払い処理APIの詳細な要件 +3. **移行要件**: データ移行、ユーザートレーニング、ロールバック手順を含むレガシーシステムの近代化要件 + +**最適な組み合わせ**: システムアーキテクト (技術的実現可能性)、テクニカルライター (ドキュメント作成)、学習ガイド (ユーザーガイダンス) + +### コミュニケーションと学習エージェント 📚 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#communication--learning-agents-) + +### テクニカルライター 📚 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#technical-writer-) + +**専門分野**: 視聴者分析と明確さを重視した技術文書作成とコミュニケーション + +**自動アクティベーション**: + +- キーワード: 「ドキュメント」、「Readme」、「API ドキュメント」、「ユーザー ガイド」、「テクニカル ライティング」、「マニュアル」 +- コンテキスト: ドキュメントのリクエスト、API ドキュメント、ユーザー ガイド、技術的な説明 +- ファイルタイプ: .md、.rst、API 仕様、ドキュメント ファイル + +**機能**: + +- 技術文書のアーキテクチャと情報設計 +- さまざまなスキルレベルに合わせたオーディエンス分析とコンテンツターゲティング +- 動作例と統合ガイダンスを含む API ドキュメント +- ステップバイステップの手順とトラブルシューティングを記載したユーザーガイドの作成 +- アクセシビリティ基準の適用と包括的な言語の使用 + +**例**: + +1. **APIドキュメント**: 認証、エンドポイント、例、SDK統合ガイドを含む包括的なREST APIドキュメント +2. **ユーザーマニュアル**: スクリーンショット、トラブルシューティング、FAQセクションを含むステップバイステップのインストールおよび構成ガイド +3. **技術仕様**: 図、データフロー、実装の詳細を含むシステムアーキテクチャドキュメント + +**最適な組み合わせ**: requirements-analyst (仕様の明確化)、learning-guide (教育コンテンツ)、frontend-architect (UI ドキュメント) + +--- + +### 学習ガイド 🎓 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#learning-guide-) + +**専門分野**：スキル開発とメンターシップに重点を置いた教育コンテンツの設計と漸進的学習 + +**自動アクティベーション**: + +- キーワード: 「説明」、「学習」、「チュートリアル」、「初心者」、「指導」、「教育」、「トレーニング」 +- コンテキスト: 教育的なリクエスト、概念の説明、スキル開発、学習パス +- 複雑さ: 段階的な分解と段階的な理解を必要とする複雑なトピック + +**機能**: + +- 段階的なスキル開発を伴う学習パスの設計 +- 類推と例による複雑な概念の説明 +- 実践的な演習を含むインタラクティブなチュートリアルの作成 +- スキル評価と能力評価のフレームワーク +- メンターシップ戦略と個別学習アプローチ + +**例**: + +1. **プログラミングチュートリアル**: 実践的な演習、コード例、段階的な複雑さを備えたインタラクティブな React チュートリアル +2. **概念の説明**: 視覚的な図と練習問題を使った実際の例を通してデータベースの正規化を説明します +3. **スキル評価**：実践的なプロジェクトとフィードバックによるフルスタック開発のための包括的な評価フレームワーク + +**最適な対象者**: テクニカルライター (教育ドキュメント)、フロントエンドアーキテクト (インタラクティブ学習)、要件アナリスト (学習目標) + +--- + +## エージェントの調整と統合 🤝 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-coordination--integration-) + +### 調整パターン + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#coordination-patterns) + +**アーキテクチャチーム**: + +- **フルスタック開発**：フロントエンドアーキテクト + バックエンドアーキテクト + セキュリティエンジニア + 品質エンジニア +- **システム設計**: システムアーキテクト + DevOps アーキテクト + パフォーマンスエンジニア + セキュリティエンジニア +- **レガシーモダナイゼーション**：リファクタリング専門家 + システムアーキテクト + 品質エンジニア + テクニカルライター + +**品質チーム**: + +- **セキュリティ監査**: セキュリティエンジニア + 品質エンジニア + 根本原因アナリスト + 要件アナリスト +- **パフォーマンス最適化**: パフォーマンスエンジニア + システムアーキテクト + DevOps アーキテクト + 根本原因アナリスト +- **テスト戦略**: 品質エンジニア + セキュリティエンジニア + パフォーマンスエンジニア + フロントエンドアーキテクト + +**コミュニケーションチーム**: + +- **ドキュメンテーションプロジェクト**: テクニカルライター + 要件アナリスト + 学習ガイド + ドメインエキスパート +- **学習プラットフォーム**: 学習ガイド + フロントエンドアーキテクト + テクニカルライター + 品質エンジニア +- **APIドキュメント**: バックエンドアーキテクト + テクニカルライター + セキュリティエンジニア + 品質エンジニア + +### MCP サーバー統合 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#mcp-server-integration) + +**MCP サーバーによる拡張機能**: + +- **コンテキスト7** : すべての建築家と専門家のための公式ドキュメントパターン +- **シーケンシャル**: 根本原因アナリスト、システムアーキテクト、パフォーマンスエンジニア向けの多段階分析 +- **マジック**：フロントエンドアーキテクト、学習ガイドインタラクティブコンテンツのためのUI生成 +- **Playwright** : 品質エンジニア向けのブラウザテスト、フロントエンドアーキテクト向けのアクセシビリティ検証 +- **Morphllm** : refactoring-expert のコード変換、python-expert の一括変更 +- **Serena** : すべてのエージェントのプロジェクトメモリ、セッション間のコンテキスト保存 + +### エージェントのアクティベーションのトラブルシューティング + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#troubleshooting-agent-activation) + +## トラブルシューティング + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.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/agents.md#common-issues) + +- **エージェントのアクティベーションなし**: ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します +- **間違ったエージェントが選択されました**: エージェントのドキュメントでトリガーキーワードを確認してください +- **エージェントが多すぎる場合**：主要ドメインのキーワードに焦点を当てるか、`/sc:focus [domain]` +- **エージェントが連携していない**: タスクの複雑さを増やすか、マルチドメインキーワードを使用する +- **エージェントの専門知識の不一致**: より具体的な技術用語を使用する + +### 即時修正 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#immediate-fixes) + +- **エージェントの強制アクティベーション**: リクエストで明示的なドメインキーワードを使用する +- **エージェントの選択をリセット**: エージェントの状態をリセットするには、Claude Code セッションを再起動します。 +- **エージェントのパターンを確認する**: エージェントのドキュメントでトリガーキーワードを確認する +- **基本的なアクティベーションをテストする**:`/sc:implement "security auth"`セキュリティエンジニアのテストを試みる + +### エージェント固有のトラブルシューティング + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-specific-troubleshooting) + +**セキュリティエージェントなし:** + +```shell +# Problem: Security concerns not triggering security-engineer +# Quick Fix: Use explicit security keywords +"implement authentication" # Generic - may not trigger +"implement JWT authentication security" # Explicit - triggers security-engineer +"secure user login with encryption" # Security focus - triggers security-engineer +``` + +**パフォーマンスエージェントなし:** + +```shell +# Problem: Performance issues not triggering performance-engineer +# Quick Fix: Use performance-specific terminology +"make it faster" # Vague - may not trigger +"optimize slow database queries" # Specific - triggers performance-engineer +"reduce API latency and bottlenecks" # Performance focus - triggers performance-engineer +``` + +**アーキテクチャエージェントなし:** + +```shell +# Problem: System design not triggering architecture agents +# Quick Fix: Use architectural keywords +"build an app" # Generic - triggers basic agents +"design microservices architecture" # Specific - triggers system-architect +"scalable distributed system design" # Architecture focus - triggers system-architect +``` + +**間違ったエージェントの組み合わせ:** + +```shell +# Problem: Getting frontend agent for backend tasks +# Quick Fix: Use domain-specific terminology +"create user interface" # May trigger frontend-architect +"create REST API endpoints" # Specific - triggers backend-architect +"implement server-side authentication" # Backend focus - triggers backend-architect +``` + +### サポートレベル + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#support-levels) + +**クイックフィックス:** + +- エージェントトリガーテーブルから明示的なドメインキーワードを使用する +- Claude Codeセッションを再起動してみてください +- 混乱を避けるために単一のドメインに焦点を当てる + +**詳細なヘルプ:** + +- エージェントのインストールに関する問題については、[一般的な問題ガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/common-issues.md)を参照してください。 +- 対象エージェントのトリガーキーワードを確認する + +**専門家によるサポート:** + +- 使用`SuperClaude install --diagnose` +- 協調分析については[診断リファレンスガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/diagnostic-reference.md)を参照してください + +**コミュニティサポート:** + +- [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/agents.md#success-validation) + +エージェントの修正を適用した後、次のようにテストします。 + +- [ ] ドメイン固有のリクエストは適切なエージェントをアクティブ化します（セキュリティ → セキュリティ エンジニア） +- [ ] 複雑なタスクはマルチエージェント調整（3 つ以上のエージェント）をトリガーします +- [ ] エージェントの専門知識がタスク要件に一致している（API → バックエンドアーキテクト） +- [ ] 適切な場合に品質エージェントが自動的に含められます（セキュリティ、パフォーマンス、テスト） +- [ ] 回答はドメインの専門知識と専門知識を示す + +## クイックトラブルシューティング（レガシー） + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quick-troubleshooting-legacy) + +- **エージェントが有効化されていない場合**→ ドメインキーワード「セキュリティ」、「パフォーマンス」、「フロントエンド」を使用します +- **エージェントが間違っている**→ エージェントのドキュメントでトリガーキーワードを確認してください +- **エージェントが多すぎる**→ 主要ドメインのキーワードに焦点を絞る +- **エージェントが連携していない**→ タスクの複雑さを増やすか、マルチドメインキーワードを使用する + +**エージェントがアクティブ化されない?** + +1. **キーワードを確認する**: ドメイン固有の用語を使用する (例: セキュリティ エンジニアの場合は「ログイン」ではなく「認証」) +2. **コンテキストを追加**: ファイルの種類、フレームワーク、または特定のテクノロジーを含める +3. **複雑さの増大**：マルチドメインの問題はより多くのエージェントをトリガーします +4. **使用例**: エージェントの専門知識に合った具体的なシナリオを参照する + +**エージェントが多すぎますか?** + +- 主要なドメインのニーズにキーワードを集中させる +- `/sc:focus [domain]`範囲を制限するために使用する +- 特定のエージェントから始めて、必要に応じて拡張します + +**エージェントが間違っていますか?** + +- エージェントのドキュメントでトリガーキーワードを確認する +- 対象ドメインに対してより具体的な用語を使用する +- 明示的な要件または制約を追加する + +## クイックリファレンス 📋 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quick-reference-) + +### エージェントトリガー検索 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-trigger-lookup) + +|トリガータイプ|キーワード/パターン|活性化エージェント| +|---|---|---| +|**安全**|「認証」、「セキュリティ」、「脆弱性」、「暗号化」|セキュリティエンジニア| +|**パフォーマンス**|「遅い」、「最適化」、「ボトルネック」、「レイテンシー」|パフォーマンスエンジニア| +|**フロントエンド**|「UI」、「React」、「Vue」、「コンポーネント」、「レスポンシブ」|フロントエンドアーキテクト| +|**バックエンド**|「API」、「サーバー」、「データベース」、「REST」、「GraphQL」|バックエンドアーキテクト| +|**テスト**|「テスト」、「QA」、「検証」、「カバレッジ」|品質エンジニア| +|**デブオプス**|「デプロイ」、「CI/CD」、「Docker」、「Kubernetes」|DevOpsアーキテクト| +|**建築**|「アーキテクチャ」、「マイクロサービス」、「スケーラビリティ」|システムアーキテクト| +|**パイソン**|「.py」、「Django」、「FastAPI」、「asyncio」|Pythonエキスパート| +|**問題**|「バグ」、「問題」、「デバッグ」、「トラブルシューティング」|根本原因分析者| +|**コード品質**|「リファクタリング」、「クリーンコード」、「技術的負債」|リファクタリングの専門家| +|**ドキュメント**|「ドキュメント」、「Readme」、「APIドキュメント」|テクニカルライター| +|**学ぶ**|「説明する」、「チュートリアル」、「初心者」、「教える」|学習ガイド| +|**要件**|「要件」、「PRD」、「仕様」|要件アナリスト| + +### コマンドエージェントマッピング + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#command-agent-mapping) + +|指示|主な薬剤|サポートエージェント| +|---|---|---| +|`/sc:implement`|ドメインアーキテクト（フロントエンド、バックエンド）|セキュリティエンジニア、品質エンジニア| +|`/sc:analyze`|品質エンジニア、セキュリティエンジニア|パフォーマンスエンジニア、根本原因アナリスト| +|`/sc:troubleshoot`|根本原因分析者|ドメインスペシャリスト、パフォーマンスエンジニア| +|`/sc:improve`|リファクタリングの専門家|品質エンジニア、パフォーマンスエンジニア| +|`/sc:document`|テクニカルライター|ドメインスペシャリスト、学習ガイド| +|`/sc:design`|システムアーキテクト|ドメインアーキテクト、要件アナリスト| +|`/sc:test`|品質エンジニア|セキュリティエンジニア、パフォーマンスエンジニア| +|`/sc:explain`|学習ガイド|テクニカルライター、ドメインスペシャリスト| + +### 効果的な薬剤の組み合わせ + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#effective-agent-combinations) + +**開発ワークフロー**: + +- Web アプリケーション: フロントエンド アーキテクト + バックエンド アーキテクト + セキュリティ エンジニア + 品質エンジニア + DevOps アーキテクト +- API開発: バックエンドアーキテクト + セキュリティエンジニア + テクニカルライター + 品質エンジニア +- データ プラットフォーム: Python エキスパート + パフォーマンス エンジニア + セキュリティ エンジニア + システム アーキテクト + +**分析ワークフロー**: + +- セキュリティ監査: セキュリティエンジニア + 品質エンジニア + 根本原因アナリスト + テクニカルライター +- パフォーマンス調査: パフォーマンスエンジニア + 根本原因アナリスト + システムアーキテクト + DevOps アーキテクト +- レガシー評価: リファクタリング専門家 + システムアーキテクト + 品質エンジニア + セキュリティエンジニア + テクニカルライター + +**コミュニケーションワークフロー**: + +- 技術ドキュメント: テクニカルライター + 要件アナリスト + ドメインエキスパート + 学習ガイド +- 教育コンテンツ: 学習ガイド + テクニカルライター + フロントエンドアーキテクト + 品質エンジニア + +## ベストプラクティス💡 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#best-practices-) + +### はじめに（シンプルなアプローチ） + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#getting-started-simple-approach) + +**自然言語ファースト:** + +1. **目標を記述する**: ドメイン固有のキーワードを含む自然言語を使用する +2. **信頼の自動アクティベーション**: システムが適切なエージェントに自動的にルーティングできるようにします +3. **パターンから学ぶ**: さまざまなリクエストタイプに対してどのエージェントがアクティブになるかを観察する +4. **反復と改良**: 専門エージェントを追加するために詳細度を追加します + +### エージェントの選択の最適化 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#optimizing-agent-selection) + +**効果的なキーワードの使用法:** + +- **特定 > 汎用**: セキュリティエンジニアの場合は「ログイン」の代わりに「認証」を使用します +- **技術用語**: フレームワーク名、テクノロジー、具体的な課題など +- **コンテキストヒント**: ファイルの種類、プロジェクトの範囲、複雑さの指標について言及する +- **品質キーワード**: 包括的なカバレッジのために「セキュリティ」、「パフォーマンス」、「アクセシビリティ」を追加します + +**リクエストの最適化の例:** + +```shell +# Generic (limited agent activation) +"Fix the login feature" + +# Optimized (multi-agent coordination) +"Implement secure JWT authentication with rate limiting and accessibility compliance" +# → Triggers: security-engineer + backend-architect + frontend-architect + quality-engineer +``` + +### 一般的な使用パターン + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#common-usage-patterns) + +**開発ワークフロー:** + +```shell +# Full-stack feature development +/sc:implement "responsive user dashboard with real-time notifications" +# → frontend-architect + backend-architect + performance-engineer + +# API development with documentation +/sc:create "REST API for payment processing with comprehensive docs" +# → backend-architect + security-engineer + technical-writer + quality-engineer + +# Performance optimization investigation +/sc:troubleshoot "slow database queries affecting user experience" +# → performance-engineer + root-cause-analyst + backend-architect +``` + +**分析ワークフロー:** + +```shell +# Security assessment +/sc:analyze "authentication system for GDPR compliance vulnerabilities" +# → security-engineer + quality-engineer + requirements-analyst + +# Code quality review +/sc:review "legacy codebase for modernization opportunities" +# → refactoring-expert + system-architect + quality-engineer + technical-writer + +# Learning and explanation +/sc:explain "microservices patterns with hands-on examples" +# → system-architect + learning-guide + technical-writer +``` + +### 高度なエージェント調整 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#advanced-agent-coordination) + +**マルチドメインプロジェクト:** + +- **幅広く始める**：システムレベルのキーワードから始めて、建築エージェントの関心を引く +- **特異性の追加**: 専門エージェントを活性化するためにドメイン固有のニーズを含める +- **品質統合**: セキュリティ、パフォーマンス、テストの観点を自動的に含めます +- **ドキュメントの包含**: 包括的なカバレッジのために学習またはドキュメントのニーズを追加します + +**エージェントの選択に関するトラブルシューティング:** + +**問題: 間違ったエージェントがアクティブ化される** + +- 解決策: より具体的なドメイン用語を使用する +- 例:「データベース最適化」→ パフォーマンスエンジニア + バックエンドアーキテクト + +**問題: エージェントが足りない** + +- 解決策: 複雑性指標とクロスドメインキーワードを増やす +- 例: リクエストに「セキュリティ」、「パフォーマンス」、「ドキュメント」を追加する + +**問題: エージェントが多すぎる** + +- 解決策: 特定の技術用語を含む主要ドメインに焦点を当てる +- 例: スコープを制限するには「/sc:focus backend」を使用します + +### 品質重視の開発 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#quality-driven-development) + +**セキュリティ第一のアプローチ:** 開発リクエストには常にセキュリティに関する考慮事項を含め、ドメインスペシャリストとともにセキュリティエンジニアを自動的に関与させます。 + +**パフォーマンス統合:** パフォーマンス キーワード (「高速」、「効率的」、「スケーラブル」) を含めて、最初からパフォーマンス エンジニアの調整を確実にします。 + +**アクセシビリティ コンプライアンス:** 「accessible」、「WCAG」、または「inclusive」を使用して、フロントエンド開発にアクセシビリティ検証を自動的に含めます。 + +**ドキュメント文化:** テクニカルライターの自動的な参加と知識の移転のリクエストに「ドキュメント化」、「説明」、または「チュートリアル」を追加します。 + +--- + +## エージェントインテリジェンスを理解する🧠 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#understanding-agent-intelligence-) + +### エージェントを効果的にする要素 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#what-makes-agents-effective) + +**ドメイン専門知識**: 各エージェントは、それぞれのドメインに特有の専門的な知識パターン、行動アプローチ、問題解決方法論を備えています。 + +**コンテキスト アクティベーション**: エージェントは、キーワードだけでなくリクエストのコンテキストを分析して、関連性とエンゲージメント レベルを判断します。 + +**協調的インテリジェンス**: 複数のエージェントの調整により、個々のエージェントの能力を超える相乗的な結果が生まれます。 + +**適応学習**: リクエストパターンと成功した調整結果に基づいてエージェントの選択が改善されます。 + +### エージェント vs. 従来のAI + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#agent-vs-traditional-ai) + +**従来のアプローチ**: 単一のAIが、さまざまなレベルの専門知識を持つすべてのドメインを処理します。 **エージェントアプローチ**: 専門のエキスパートが、深いドメイン知識と集中的な問題解決で協力します。 + +**利点**： + +- ドメイン固有のタスクにおける高い精度 +- より洗練された問題解決方法論 +- 専門家によるレビューによる品質保証の向上 +- 協調的な多角的分析 + +### システムを信頼し、パターンを理解する + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#trust-the-system-understand-the-patterns) + +**期待すること**: + +- 適切なドメイン専門家への自動ルーティング +- 複雑なタスクのためのマルチエージェント調整 +- 自動QAエージェントの組み込みによる品質統合 +- 教育エージェントの活性化による学習機会 + +**心配する必要がないこと**： + +- エージェントの手動選択または構成 +- 複雑なルーティングルールやエージェント管理 +- エージェントの構成または調整 +- エージェントとのやり取りを細かく管理する + +--- + +## 関連リソース 📚 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#related-resources-) + +### 必須ドキュメント + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#essential-documentation) + +- **[コマンドガイド](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md)**- 最適なエージェント調整をトリガーするSuperClaudeコマンドをマスターする +- **[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/User-Guide/agents.md#advanced-usage) + +- **[行動モード](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/modes.md)**- エージェントの調整を強化するためのコンテキスト最適化 +- **[はじめに](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Getting-Started/quick-start.md)**- エージェントの最適化のための専門家のテクニック +- **[例のクックブック](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Reference/examples-cookbook.md)**- 現実世界のエージェントの調整パターン + +### 開発リソース + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#development-resources) + +- **[技術アーキテクチャ](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/technical-architecture.md)**- SuperClaude のエージェント システム設計を理解する +- **[貢献](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/Developer-Guide/contributing-code.md)**- エージェントの機能と調整パターンの拡張 + +--- + +## エージェントとしての道のり 🚀 + +[](https://github.com/khayashi4337/SuperClaude_Framework/blob/master/Docs/User-Guide/agents.md#your-agent-journey-) + +**第1週：自然な使用法** 自然な言語による説明から始めましょう。どのエージェントが、そしてなぜアクティブになるのかに注目しましょう。プロセスを考えすぎずに、キーワードのパターンに対する直感を養います。 + +**第2～3週：パターン認識** +エージェントの連携パターンを観察します。複雑さとドメインキーワードがエージェントの選択にどのような影響を与えるかを理解します。連携を向上させるために、リクエストの表現を最適化します。 + +**2ヶ月目以降：エキスパートコーディネーション** 最適なエージェントの組み合わせをトリガーするマルチドメインリクエストをマスターします。トラブルシューティング手法を活用して効果的なエージェント選定を行います。複雑なワークフローには高度なパターンを使用します。 + +**SuperClaudeのメリット：** 14名の専門AIエキスパートが、シンプルな自然言語によるリクエストに連携して対応します。設定や管理は不要で、ニーズに合わせて拡張できるインテリジェントな連携を実現します。 + +🎯**インテリジェントエージェントコーディネーションを体験する準備はできましたか？まずは`/sc:implement`、専門的な AI コラボレーションの魔法を発見してください。** \ No newline at end of file diff --git a/Docs/User-Guide-jp/commands.md b/Docs/User-Guide-jp/commands.md new file mode 100644 index 0000000..3310aa3 --- /dev/null +++ b/Docs/User-Guide-jp/commands.md @@ -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)- 実際の使用パターン \ No newline at end of file diff --git a/Docs/User-Guide-jp/flags.md b/Docs/User-Guide-jp/flags.md new file mode 100644 index 0000000..50e2c80 --- /dev/null +++ b/Docs/User-Guide-jp/flags.md @@ -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%、効率性のニーズ|シンボル強化通信、30～50%削減| + +### 実行制御フラグ + +[](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)- 永続セッションでのフラグの使用 \ No newline at end of file diff --git a/Docs/User-Guide-jp/mcp-servers.md b/Docs/User-Guide-jp/mcp-servers.md new file mode 100644 index 0000000..9f636fe --- /dev/null +++ b/Docs/User-Guide-jp/mcp-servers.md @@ -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)- 統合の詳細 \ No newline at end of file diff --git a/Docs/User-Guide-jp/modes.md b/Docs/User-Guide-jp/modes.md new file mode 100644 index 0000000..213025d --- /dev/null +++ b/Docs/User-Guide-jp/modes.md @@ -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`フラグ|シンボルシステム、推定30～50%のトークン削減|リソースの制約、大規模な操作| + +--- + +## はじめに（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: 詳細なヘルプ（5～15分）** + +```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: モードは調整を通じてツールの使用を最適化します。 + +- **トークン効率**: 30～50%のコンテキスト削減 +- **オーケストレーション**：並列処理 +- **タスク管理**：体系的な計画を通じて手戻りを防止 + +**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)- 動作モードの設定 + +**🌿中級（第2～3週）** + +- [エージェントガイド](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) \ No newline at end of file diff --git a/Docs/User-Guide-jp/session-management.md b/Docs/User-Guide-jp/session-management.md new file mode 100644 index 0000000..3ecd744 --- /dev/null +++ b/Docs/User-Guide-jp/session-management.md @@ -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 の会話にわたってコンテキスト、決定、学習が維持されます。 \ No newline at end of file