-## 🎉 **V4の新機能**
+## 🎉 **V4.1の新機能**
-> *バージョン4は、コミュニティフィードバックと実際の使用パターンに基づいて重要な改善をもたらします。*
+> *バージョン4.1は、スラッシュコマンドアーキテクチャの安定化、エージェント機能の強化、ドキュメントの改善に焦点を当てています。*
|
### 🤖 **よりスマートなエージェントシステム**
-**14の専門エージェント**がドメイン専門知識を持ちます：
+ドメイン専門知識を持つ**16の専門エージェント**：
+- PM Agentは体系的なドキュメントを通じて継続的な学習を保証
+- 自律的なウェブ研究のための深い研究エージェント
- セキュリティエンジニアが実際の脆弱性をキャッチ
- フロントエンドアーキテクトがUIパターンを理解
- コンテキストに基づく自動調整
@@ -197,43 +245,6 @@ pip install --break-system-packages SuperClaude
|
-### 📝 **改良された名前空間**
-すべてのコマンドに**`/sc:`プレフィックス**：
-- カスタムコマンドとの競合なし
-- 完全なライフサイクルをカバーする21のコマンド
-- ブレインストーミングからデプロイメントまで
-- 整理されたコマンド構造
-
- |
-
-
-|
-
-### 🔧 **MCPサーバー統合**
-**6つの強力なサーバー**が連携：
-- **Context7** → 最新ドキュメント
-- **Sequential** → 複雑な分析
-- **Magic** → UIコンポーネント生成
-- **Playwright** → ブラウザテスト
-- **Morphllm** → 一括変換
-- **Serena** → セッション持続
-
- |
-
-
-### 🎯 **動作モード**
-異なるコンテキストのための**5つの適応モード**：
-- **ブレインストーミング** → 適切な質問をする
-- **オーケストレーション** → 効率的なツール調整
-- **トークン効率** → 30-50%のコンテキスト節約
-- **タスク管理** → システム化された組織
-- **内省** → メタ認知分析
-
- |
-
-
-|
-
### ⚡ **最適化されたパフォーマンス**
**より小さなフレームワーク、より大きなプロジェクト：**
- フレームワークフットプリントの削減
@@ -242,6 +253,37 @@ pip install --break-system-packages SuperClaude
- 複雑な操作の有効化
|
+
+
+|
+
+### 🔧 **MCPサーバー統合**
+**8つの強力なサーバー**（airis-mcp-gateway経由）：
+- **Tavily** → プライマリウェブ検索（深い研究）
+- **Serena** → セッション持続性とメモリ
+- **Mindbase** → セッション横断学習（ゼロフットプリント）
+- **Sequential** → トークン効率的な推論
+- **Context7** → 公式ドキュメント検索
+- **Playwright** → JavaScript重量コンテンツ抽出
+- **Magic** → UIコンポーネント生成
+- **Chrome DevTools** → パフォーマンス分析
+
+ |
+
+
+### 🎯 **動作モード**
+異なるコンテキストのための**7つの適応モード**：
+- **ブレインストーミング** → 適切な質問をする
+- **ビジネスパネル** → 多専門家戦略分析
+- **深い研究** → 自律的なウェブ研究
+- **オーケストレーション** → 効率的なツール調整
+- **トークン効率** → 30-50%のコンテキスト節約
+- **タスク管理** → システム化された組織
+- **内省** → メタ認知分析
+
+ |
+
+
|
### 📚 **ドキュメントの全面見直し**
@@ -251,6 +293,16 @@ pip install --break-system-packages SuperClaude
- 実用的なワークフローを含む
- より良いナビゲーション構造
+ |
+
+
+### 🧪 **安定性の強化**
+**信頼性に焦点：**
+- コアコマンドのバグ修正
+- テストカバレッジの改善
+- より堅牢なエラー処理
+- CI/CDパイプラインの改善
+
|
@@ -261,6 +313,98 @@ pip install --break-system-packages SuperClaude
+## 🔬 **深い研究機能**
+
+### **DRエージェントアーキテクチャに準拠した自律的ウェブ研究**
+
+SuperClaude v4.2は、自律的、適応的、インテリジェントなウェブ研究を可能にする包括的な深い研究機能を導入します。
+
+
+
+|
+
+### 🎯 **適応的計画**
+**3つのインテリジェント戦略：**
+- **計画のみ**：明確なクエリに対する直接実行
+- **意図計画**：曖昧なリクエストの明確化
+- **統一**：協調的な計画の洗練（デフォルト）
+
+ |
+
+
+### 🔄 **マルチホップ推論**
+**最大5回の反復検索：**
+- エンティティ拡張（論文 → 著者 → 作品）
+- 概念深化（トピック → 詳細 → 例）
+- 時間的進行（現在 → 歴史）
+- 因果連鎖（効果 → 原因 → 予防）
+
+ |
+
+
+|
+
+### 📊 **品質スコアリング**
+**信頼度ベースの検証：**
+- ソースの信頼性評価（0.0-1.0）
+- カバレッジの完全性追跡
+- 統合の一貫性評価
+- 最小しきい値：0.6、目標：0.8
+
+ |
+
+
+### 🧠 **ケースベース学習**
+**セッション横断インテリジェンス：**
+- パターン認識と再利用
+- 時間経過による戦略最適化
+- 成功したクエリ式の保存
+- パフォーマンス改善追跡
+
+ |
+
+
+
+### **研究コマンドの使用**
+
+```bash
+# 自動深度での基本研究
+/research "2024年の最新AI開発"
+
+# 制御された研究深度（TypeScriptのオプション経由）
+/research "量子コンピューティングのブレークスルー" # depth: exhaustive
+
+# 特定の戦略選択
+/research "市場分析" # strategy: planning-only
+
+# ドメインフィルタリング研究（Tavily MCP統合）
+/research "Reactパターン" # domains: reactjs.org,github.com
+```
+
+### **研究深度レベル**
+
+| 深度 | ソース | ホップ | 時間 | 最適な用途 |
+|:-----:|:-------:|:----:|:----:|----------|
+| **クイック** | 5-10 | 1 | ~2分 | 簡単な事実、単純なクエリ |
+| **標準** | 10-20 | 3 | ~5分 | 一般的な研究（デフォルト） |
+| **深い** | 20-40 | 4 | ~8分 | 包括的な分析 |
+| **徹底的** | 40+ | 5 | ~10分 | 学術レベルの研究 |
+
+### **統合ツールオーケストレーション**
+
+深い研究システムは複数のツールをインテリジェントに調整します：
+- **Tavily MCP**：プライマリウェブ検索と発見
+- **Playwright MCP**：複雑なコンテンツ抽出
+- **Sequential MCP**：マルチステップ推論と統合
+- **Serena MCP**：メモリと学習の持続性
+- **Context7 MCP**：技術ドキュメント検索
+
+
+
+---
+
+
+
## 📚 **ドキュメント**
### **🇯🇵 SuperClaude完全日本語ガイド**
@@ -284,22 +428,22 @@ pip install --break-system-packages SuperClaude
-- 🎯 [**コマンドリファレンス**](docs/user-guide-jp/commands.md)
- *全21のスラッシュコマンド*
+- 🎯 [**スラッシュコマンド**](docs/user-guide/commands.md)
+ *完全な `/sc` コマンドリスト*
-- 🤖 [**エージェントガイド**](docs/user-guide-jp/agents.md)
- *14の専門エージェント*
+- 🤖 [**エージェントガイド**](docs/user-guide/agents.md)
+ *16の専門エージェント*
-- 🎨 [**動作モード**](docs/user-guide-jp/modes.md)
- *5つの適応モード*
+- 🎨 [**動作モード**](docs/user-guide/modes.md)
+ *7つの適応モード*
-- 🚩 [**フラグガイド**](docs/user-guide-jp/flags.md)
+- 🚩 [**フラグガイド**](docs/user-guide/flags.md)
*動作制御パラメータ*
-- 🔧 [**MCPサーバー**](docs/user-guide-jp/mcp-servers.md)
- *6つのサーバー統合*
+- 🔧 [**MCPサーバー**](docs/user-guide/mcp-servers.md)
+ *8つのサーバー統合*
-- 💼 [**セッション管理**](docs/user-guide-jp/session-management.md)
+- 💼 [**セッション管理**](docs/user-guide/session-management.md)
*状態の保存と復元*
|
@@ -317,13 +461,10 @@ pip install --break-system-packages SuperClaude
-- ✨ [**ベストプラクティス**](docs/reference/basic-examples.md)
- *プロのコツとパターン*
-
-- 📓 [**サンプル集**](docs/reference/examples-cookbook.md)
+- 📓 [**サンプル集**](docs/reference/examples-cookbook.md)
*実際の使用例*
-- 🔍 [**トラブルシューティング**](docs/reference/troubleshooting.md)
+- 🔍 [**トラブルシューティング**](docs/reference/troubleshooting.md)
*一般的な問題と修正*
|
diff --git a/README-kr.md b/README-kr.md
index a7795e6..dcbdc03 100644
--- a/README-kr.md
+++ b/README-kr.md
@@ -54,10 +54,12 @@
## 📊 **프레임워크 통계**
-| **명령어 수** | **에이전트** | **모드** | **MCP 서버** |
+| **플러그인** | **에이전트** | **모드** | **MCP 서버** |
|:------------:|:----------:|:---------:|:---------------:|
-| **21** | **14** | **5** | **6** |
-| 슬래시 명령어 | 전문 AI | 작동 모드 | 통합 서비스 |
+| **3** | **16** | **7** | **8** |
+| 플러그인 명령어 | 전문 AI | 동작 모드 | 통합 서비스 |
+
+세 가지 핵심 플러그인: **PM Agent**(오케스트레이션), **Research**(웹 검색), **Index**(컨텍스트 최적화).
@@ -69,57 +71,101 @@
SuperClaude는 **메타프로그래밍 설정 프레임워크**로, 동작 지시 주입과 컴포넌트 통제를 통해 Claude Code를 구조화된 개발 플랫폼으로 변환합니다. 강력한 도구와 지능형 에이전트를 갖춘 체계적인 워크플로우 자동화를 제공합니다.
+
+## 면책 조항
+
+이 프로젝트는 Anthropic과 관련이 없거나 승인받지 않았습니다.
+Claude Code는 [Anthropic](https://www.anthropic.com/)에 의해 구축 및 유지 관리되는 제품입니다.
+
+## 📖 **개발자 및 기여자를 위한 안내**
+
+**SuperClaude 프레임워크 작업을 위한 필수 문서:**
+
+| 문서 | 목적 | 언제 읽을까 |
+|----------|---------|--------------|
+| **[PLANNING.md](PLANNING.md)** | 아키텍처, 설계 원칙, 절대 규칙 | 세션 시작, 구현 전 |
+| **[TASK.md](TASK.md)** | 현재 작업, 우선순위, 백로그 | 매일, 작업 시작 전 |
+| **[KNOWLEDGE.md](KNOWLEDGE.md)** | 축적된 통찰력, 모범 사례, 문제 해결 | 문제 발생 시, 패턴 학습 시 |
+| **[CONTRIBUTING.md](CONTRIBUTING.md)** | 기여 가이드라인, 워크플로우 | PR 제출 전 |
+
+> **💡 전문가 팁**: Claude Code는 세션 시작 시 이러한 파일을 읽어 프로젝트 표준에 부합하는 일관되고 고품질의 개발을 보장합니다.
+
## ⚡ **빠른 설치**
-### **설치 방법 선택**
+> **중요**: 이전 문서에서 설명한 TypeScript 플러그인 시스템은
+> 아직 사용할 수 없습니다(v5.0에서 계획). v4.x의 현재 설치
+> 지침은 아래 단계를 따르세요.
-| 방법 | 명령어 | 최적 사용처 |
-|:------:|---------|----------|
-| **🐍 pipx** | `pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install` | **✅ 권장** - Linux/macOS |
-| **📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | 기존 Python 환경 |
-| **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | 크로스 플랫폼, Node.js 사용자 |
+### **현재 안정 버전 (v4.1.8)**
+
+SuperClaude는 현재 슬래시 명령어를 사용합니다.
+
+**옵션 1: pipx (권장)**
+```bash
+# PyPI에서 설치
+pipx install superclaude
+
+# 명령어 설치 (/research, /index-repo, /agent, /recommend 설치)
+superclaude install
+
+# 설치 확인
+superclaude install --list
+superclaude doctor
+```
+
+설치 후, 명령어를 사용하려면 Claude Code를 재시작하세요:
+- `/sc:research` - 병렬 검색으로 심층 웹 연구
+- `/sc:index-repo` - 컨텍스트 최적화를 위한 리포지토리 인덱싱
+- `/sc:agent` - 전문 AI 에이전트
+- `/sc:recommend` - 명령어 추천
+- `/sc` - 사용 가능한 모든 SuperClaude 명령어 표시
+
+**옵션 2: Git에서 직접 설치**
+```bash
+# 리포지토리 클론
+git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
+cd SuperClaude_Framework
+
+# 설치 스크립트 실행
+./install.sh
+```
+
+### **v5.0에서 제공 예정 (개발 중)**
+
+새로운 TypeScript 플러그인 시스템을 적극적으로 개발 중입니다(자세한 내용은 [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419) 참조). 릴리스 후 설치는 다음과 같이 단순화됩니다:
+
+```bash
+# 이 기능은 아직 사용할 수 없습니다
+/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
+/plugin install superclaude
+```
+
+**상태**: 개발 중. ETA는 설정되지 않았습니다.
+
+### **향상된 성능 (선택적 MCP)**
+
+**2-3배** 빠른 실행과 **30-50%** 적은 토큰을 위해 선택적으로 MCP 서버를 설치할 수 있습니다:
+
+```bash
+# 향상된 성능을 위한 선택적 MCP 서버 (airis-mcp-gateway 경유):
+# - Serena: 코드 이해 (2-3배 빠름)
+# - Sequential: 토큰 효율적 추론 (30-50% 적은 토큰)
+# - Tavily: 심층 연구를 위한 웹 검색
+# - Context7: 공식 문서 검색
+# - Mindbase: 모든 대화에 걸친 의미론적 검색 (선택적 향상)
+
+# 참고: 오류 학습은 내장 ReflexionMemory를 통해 사용 가능 (설치 불필요)
+# Mindbase는 의미론적 검색 향상을 제공 ("recommended" 프로필 필요)
+# MCP 서버 설치: https://github.com/agiletec-inc/airis-mcp-gateway
+# 자세한 내용은 docs/mcp/mcp-integration-policy.md 참조
+```
+
+**성능 비교:**
+- **MCP 없음**: 완전히 기능함, 표준 성능 ✅
+- **MCP 사용**: 2-3배 빠름, 30-50% 적은 토큰 ⚡
@@ -182,16 +228,18 @@ pip install --break-system-packages SuperClaude
-## 🎉 **V4의 새로운 기능**
+## 🎉 **V4.1의 새로운 기능**
-> *버전 4는 커뮤니티 피드백과 실제 사용 패턴을 기반으로 중요한 개선 사항을 제공합니다.*
+> *버전 4.1은 슬래시 명령어 아키텍처 안정화, 에이전트 기능 강화 및 문서 개선에 중점을 둡니다.*
|
### 🤖 **더 스마트한 에이전트 시스템**
-**14개의 전문 에이전트**가 도메인 전문성을 제공:
+도메인 전문성을 가진 **16개의 전문 에이전트**:
+- PM Agent는 체계적인 문서화를 통해 지속적인 학습 보장
+- 자율적인 웹 연구를 위한 심층 연구 에이전트
- 보안 엔지니어가 실제 취약점 포착
- 프론트엔드 아키텍트가 UI 패턴 이해
- 컨텍스트 기반 자동 조정
@@ -200,43 +248,6 @@ pip install --break-system-packages SuperClaude
|
-### 📝 **개선된 네임스페이스**
-모든 명령어에 **`/sc:` 접두사**:
-- 커스텀 명령어와 충돌 없음
-- 전체 라이프사이클을 다루는 21개 명령어
-- 브레인스토밍부터 배포까지
-- 정리된 명령어 구조
-
- |
-
-
-|
-
-### 🔧 **MCP 서버 통합**
-**6개의 강력한 서버**가 함께 작동:
-- **Context7** → 최신 문서
-- **Sequential** → 복잡한 분석
-- **Magic** → UI 컴포넌트 생성
-- **Playwright** → 브라우저 테스트
-- **Morphllm** → 대량 변환
-- **Serena** → 세션 지속성
-
- |
-
-
-### 🎯 **작동 모드**
-다양한 컨텍스트를 위한 **5가지 적응형 모드**:
-- **브레인스토밍** → 적절한 질문하기
-- **오케스트레이션** → 효율적인 도구 조정
-- **토큰 효율성** → 30-50% 컨텍스트 절약
-- **작업 관리** → 체계적인 구성
-- **성찰** → 메타인지 분석
-
- |
-
-
-|
-
### ⚡ **최적화된 성능**
**더 작은 프레임워크, 더 큰 프로젝트:**
- 프레임워크 풋프린트 감소
@@ -245,6 +256,37 @@ pip install --break-system-packages SuperClaude
- 복잡한 작업 활성화
|
+
+
+|
+
+### 🔧 **MCP 서버 통합**
+**8개의 강력한 서버** (airis-mcp-gateway 경유):
+- **Tavily** → 주요 웹 검색(심층 연구)
+- **Serena** → 세션 지속성 및 메모리
+- **Mindbase** → 세션 간 학습(제로 풋프린트)
+- **Sequential** → 토큰 효율적 추론
+- **Context7** → 공식 문서 검색
+- **Playwright** → JavaScript 중심 콘텐츠 추출
+- **Magic** → UI 컴포넌트 생성
+- **Chrome DevTools** → 성능 분석
+
+ |
+
+
+### 🎯 **동작 모드**
+다양한 컨텍스트를 위한 **7가지 적응형 모드**:
+- **브레인스토밍** → 적절한 질문하기
+- **비즈니스 패널** → 다중 전문가 전략 분석
+- **심층 연구** → 자율적인 웹 연구
+- **오케스트레이션** → 효율적인 도구 조정
+- **토큰 효율성** → 30-50% 컨텍스트 절약
+- **작업 관리** → 체계적인 구성
+- **성찰** → 메타인지 분석
+
+ |
+
+
|
### 📚 **문서 전면 개편**
@@ -254,6 +296,16 @@ pip install --break-system-packages SuperClaude
- 실용적인 워크플로우 포함
- 개선된 탐색 구조
+ |
+
+
+### 🧪 **안정성 강화**
+**신뢰성에 중점:**
+- 핵심 명령어 버그 수정
+- 테스트 커버리지 개선
+- 더 견고한 오류 처리
+- CI/CD 파이프라인 개선
+
|
@@ -264,6 +316,98 @@ pip install --break-system-packages SuperClaude
+## 🔬 **심층 연구 기능**
+
+### **DR 에이전트 아키텍처에 맞춘 자율적 웹 연구**
+
+SuperClaude v4.2는 자율적이고 적응적이며 지능적인 웹 연구를 가능하게 하는 포괄적인 심층 연구 기능을 도입합니다.
+
+
+
+|
+
+### 🎯 **적응형 계획**
+**세 가지 지능형 전략:**
+- **계획만**: 명확한 쿼리에 대한 직접 실행
+- **의도 계획**: 모호한 요청에 대한 명확화
+- **통합**: 협업 계획 개선(기본값)
+
+ |
+
+
+### 🔄 **다중 홉 추론**
+**최대 5회 반복 검색:**
+- 엔터티 확장(논문 → 저자 → 작품)
+- 개념 심화(주제 → 세부사항 → 예제)
+- 시간적 진행(현재 → 과거)
+- 인과 체인(효과 → 원인 → 예방)
+
+ |
+
+
+|
+
+### 📊 **품질 점수**
+**신뢰도 기반 검증:**
+- 출처 신뢰성 평가(0.0-1.0)
+- 커버리지 완전성 추적
+- 종합 일관성 평가
+- 최소 임계값: 0.6, 목표: 0.8
+
+ |
+
+
+### 🧠 **사례 기반 학습**
+**세션 간 지능:**
+- 패턴 인식 및 재사용
+- 시간 경과에 따른 전략 최적화
+- 성공적인 쿼리 공식 저장
+- 성능 개선 추적
+
+ |
+
+
+
+### **연구 명령어 사용**
+
+```bash
+# 자동 깊이로 기본 연구
+/research "2024년 최신 AI 개발"
+
+# 제어된 연구 깊이(TypeScript의 옵션 통해)
+/research "양자 컴퓨팅 혁신" # depth: exhaustive
+
+# 특정 전략 선택
+/research "시장 분석" # strategy: planning-only
+
+# 도메인 필터링 연구(Tavily MCP 통합)
+/research "React 패턴" # domains: reactjs.org,github.com
+```
+
+### **연구 깊이 수준**
+
+| 깊이 | 소스 | 홉 | 시간 | 최적 용도 |
+|:-----:|:-------:|:----:|:----:|----------|
+| **빠른** | 5-10 | 1 | ~2분 | 빠른 사실, 간단한 쿼리 |
+| **표준** | 10-20 | 3 | ~5분 | 일반 연구(기본값) |
+| **심층** | 20-40 | 4 | ~8분 | 종합 분석 |
+| **철저한** | 40+ | 5 | ~10분 | 학술 수준 연구 |
+
+### **통합 도구 오케스트레이션**
+
+심층 연구 시스템은 여러 도구를 지능적으로 조정합니다:
+- **Tavily MCP**: 주요 웹 검색 및 발견
+- **Playwright MCP**: 복잡한 콘텐츠 추출
+- **Sequential MCP**: 다단계 추론 및 종합
+- **Serena MCP**: 메모리 및 학습 지속성
+- **Context7 MCP**: 기술 문서 검색
+
+
+
+---
+
+
+
## 📚 **문서**
### **🇰🇷 SuperClaude 완전 한국어 가이드**
@@ -287,22 +431,22 @@ pip install --break-system-packages SuperClaude
-- 🎯 [**명령어 레퍼런스**](docs/user-guide/commands.md)
- *전체 21개 슬래시 명령어*
+- 🎯 [**슬래시 명령어**](docs/user-guide/commands.md)
+ *완전한 `/sc` 명령어 목록*
-- 🤖 [**에이전트 가이드**](docs/user-guide/agents.md)
- *14개 전문 에이전트*
+- 🤖 [**에이전트 가이드**](docs/user-guide/agents.md)
+ *16개 전문 에이전트*
-- 🎨 [**작동 모드**](docs/user-guide/modes.md)
- *5가지 적응형 모드*
+- 🎨 [**동작 모드**](docs/user-guide/modes.md)
+ *7가지 적응형 모드*
-- 🚩 [**플래그 가이드**](docs/user-guide/flags.md)
+- 🚩 [**플래그 가이드**](docs/user-guide/flags.md)
*동작 제어 매개변수*
-- 🔧 [**MCP 서버**](docs/user-guide/mcp-servers.md)
- *6개 서버 통합*
+- 🔧 [**MCP 서버**](docs/user-guide/mcp-servers.md)
+ *8개 서버 통합*
-- 💼 [**세션 관리**](docs/user-guide/session-management.md)
+- 💼 [**세션 관리**](docs/user-guide/session-management.md)
*상태 저장 및 복원*
|
@@ -320,13 +464,10 @@ pip install --break-system-packages SuperClaude
-- ✨ [**모범 사례**](docs/reference/basic-examples.md)
- *전문가 팁과 패턴*
-
-- 📓 [**예제 모음**](docs/reference/examples-cookbook.md)
+- 📓 [**예제 모음**](docs/reference/examples-cookbook.md)
*실제 사용 예제*
-- 🔍 [**문제 해결**](docs/reference/troubleshooting.md)
+- 🔍 [**문제 해결**](docs/reference/troubleshooting.md)
*일반적인 문제와 수정*
|
diff --git a/README-zh.md b/README-zh.md
index ce682ec..08097a7 100644
--- a/README-zh.md
+++ b/README-zh.md
@@ -51,10 +51,12 @@
## 📊 **框架统计**
-| **命令数** | **智能体** | **模式** | **MCP服务器** |
+| **插件** | **智能体** | **模式** | **MCP服务器** |
|:------------:|:----------:|:---------:|:---------------:|
-| **21** | **14** | **5** | **6** |
-| 斜杠命令 | 专业AI | 行为模式 | 集成服务 |
+| **3** | **16** | **7** | **8** |
+| 插件命令 | 专业AI | 行为模式 | 集成服务 |
+
+三个核心插件：**PM Agent**（编排）、**Research**（网络搜索）、**Index**（上下文优化）。
@@ -66,57 +68,101 @@
SuperClaude是一个**元编程配置框架**，通过行为指令注入和组件编排，将Claude Code转换为结构化开发平台。它提供系统化的工作流自动化，配备强大的工具和智能代理。
+
+## 免责声明
+
+本项目与Anthropic无关联或认可。
+Claude Code是由[Anthropic](https://www.anthropic.com/)构建和维护的产品。
+
+## 📖 **开发者与贡献者指南**
+
+**使用SuperClaude框架的必备文档：**
+
+| 文档 | 用途 | 何时阅读 |
+|----------|---------|--------------|
+| **[PLANNING.md](PLANNING.md)** | 架构、设计原则、绝对规则 | 会话开始、实施前 |
+| **[TASK.md](TASK.md)** | 当前任务、优先级、待办事项 | 每天、开始工作前 |
+| **[KNOWLEDGE.md](KNOWLEDGE.md)** | 积累的见解、最佳实践、故障排除 | 遇到问题时、学习模式 |
+| **[CONTRIBUTING.md](CONTRIBUTING.md)** | 贡献指南、工作流程 | 提交PR前 |
+
+> **💡 专业提示**：Claude Code在会话开始时会读取这些文件，以确保符合项目标准的一致、高质量开发。
+
## ⚡ **快速安装**
-### **选择您的安装方式**
+> **重要**：旧文档中描述的TypeScript插件系统
+> 尚未可用（计划在v5.0中推出）。请按照以下v4.x的
+> 当前安装说明操作。
-| 方式 | 命令 | 最适合 |
-|:------:|---------|----------|
-| **🐍 pipx** | `pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install` | **✅ 推荐** - Linux/macOS |
-| **📦 pip** | `pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install` | 传统Python环境 |
-| **🌐 npm** | `npm install -g @bifrost_inc/superclaude && superclaude install` | 跨平台，Node.js用户 |
+### **当前稳定版本 (v4.1.8)**
+
+SuperClaude目前使用斜杠命令。
+
+**选项1：pipx（推荐）**
+```bash
+# 从PyPI安装
+pipx install superclaude
+
+# 安装命令（安装 /research, /index-repo, /agent, /recommend）
+superclaude install
+
+# 验证安装
+superclaude install --list
+superclaude doctor
+```
+
+安装后，重启Claude Code以使用命令：
+- `/sc:research` - 并行搜索的深度网络研究
+- `/sc:index-repo` - 用于上下文优化的仓库索引
+- `/sc:agent` - 专业AI智能体
+- `/sc:recommend` - 命令推荐
+- `/sc` - 显示所有可用的SuperClaude命令
+
+**选项2：从Git直接安装**
+```bash
+# 克隆仓库
+git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
+cd SuperClaude_Framework
+
+# 运行安装脚本
+./install.sh
+```
+
+### **v5.0即将推出（开发中）**
+
+我们正在积极开发新的TypeScript插件系统（详见issue [#419](https://github.com/SuperClaude-Org/SuperClaude_Framework/issues/419)）。发布后，安装将简化为：
+
+```bash
+# 此功能尚未可用
+/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
+/plugin install superclaude
+```
+
+**状态**：开发中。尚未设定ETA。
+
+### **增强性能（可选MCP）**
+
+要获得**2-3倍**更快的执行速度和**30-50%**更少的token消耗，可选择安装MCP服务器：
+
+```bash
+# 用于增强性能的可选MCP服务器（通过airis-mcp-gateway）：
+# - Serena: 代码理解（快2-3倍）
+# - Sequential: Token高效推理（减少30-50% token）
+# - Tavily: 用于深度研究的网络搜索
+# - Context7: 官方文档查找
+# - Mindbase: 跨所有对话的语义搜索（可选增强）
+
+# 注意：错误学习通过内置的ReflexionMemory提供（无需安装）
+# Mindbase提供语义搜索增强（需要"recommended"配置文件）
+# 安装MCP服务器：https://github.com/agiletec-inc/airis-mcp-gateway
+# 详见 docs/mcp/mcp-integration-policy.md
+```
+
+**性能对比：**
+- **不使用MCP**：功能完整，标准性能 ✅
+- **使用MCP**：快2-3倍，减少30-50% token ⚡
-
-⚠️ 重要：从SuperClaude V3升级
-
-**如果您已安装SuperClaude V3，应在安装V4前先卸载它：**
-
-```bash
-# 先卸载V3
-删除所有相关文件和目录：
-*.md *.json 和 commands/
-
-# 然后安装V4
-pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install
-```
-
-**✅ 升级时保留的内容：**
-- ✓ 您的自定义斜杠命令（`commands/sc/`之外的）
-- ✓ 您在`CLAUDE.md`中的自定义内容
-- ✓ Claude Code的`.claude.json`、`.credentials.json`、`settings.json`和`settings.local.json`
-- ✓ 您添加的任何自定义代理和文件
-
-**⚠️ 注意：** V3的其他SuperClaude相关`.json`文件可能会造成冲突，应当移除。
-
-
-
-
-💡 PEP 668错误故障排除
-
-```bash
-# 选项1：使用pipx（推荐）
-pipx install SuperClaude
-
-# 选项2：用户安装
-pip install --user SuperClaude
-
-# 选项3：强制安装（谨慎使用）
-pip install --break-system-packages SuperClaude
-```
-
-
---
@@ -179,16 +225,18 @@ pip install --break-system-packages SuperClaude
-## 🎉 **V4版本新功能**
+## 🎉 **V4.1版本新功能**
-> *第4版基于社区反馈和实际使用模式带来了重大改进。*
+> *版本4.1专注于稳定斜杠命令架构、增强智能体能力和改进文档。*
|
-### 🤖 **更智能的代理系统**
-**14个专业代理**，具有领域专业知识：
+### 🤖 **更智能的智能体系统**
+**16个专业智能体**具有领域专业知识：
+- PM Agent通过系统化文档确保持续学习
+- 深度研究智能体用于自主网络研究
- 安全工程师发现真实漏洞
- 前端架构师理解UI模式
- 基于上下文的自动协调
@@ -197,43 +245,6 @@ pip install --break-system-packages SuperClaude
|
-### 📝 **改进的命名空间**
-**`/sc:`前缀**用于所有命令：
-- 与自定义命令无冲突
-- 21个命令覆盖完整生命周期
-- 从头脑风暴到部署
-- 清晰有序的命令结构
-
- |
-
-
-|
-
-### 🔧 **MCP服务器集成**
-**6个强大服务器**协同工作：
-- **Context7** → 最新文档
-- **Sequential** → 复杂分析
-- **Magic** → UI组件生成
-- **Playwright** → 浏览器测试
-- **Morphllm** → 批量转换
-- **Serena** → 会话持久化
-
- |
-
-
-### 🎯 **行为模式**
-**5种自适应模式**适应不同上下文：
-- **头脑风暴** → 提出正确问题
-- **编排** → 高效工具协调
-- **令牌效率** → 30-50%上下文节省
-- **任务管理** → 系统化组织
-- **内省** → 元认知分析
-
- |
-
-
-|
-
### ⚡ **优化性能**
**更小的框架，更大的项目：**
- 减少框架占用
@@ -242,6 +253,37 @@ pip install --break-system-packages SuperClaude
- 启用复杂操作
|
+
+
+|
+
+### 🔧 **MCP服务器集成**
+**8个强大服务器**(通过airis-mcp-gateway)：
+- **Tavily** → 主要网络搜索(深度研究)
+- **Serena** → 会话持久化和内存
+- **Mindbase** → 跨会话学习(零占用)
+- **Sequential** → Token高效推理
+- **Context7** → 官方文档查找
+- **Playwright** → JavaScript重度内容提取
+- **Magic** → UI组件生成
+- **Chrome DevTools** → 性能分析
+
+ |
+
+
+### 🎯 **行为模式**
+**7种自适应模式**适应不同上下文：
+- **头脑风暴** → 提出正确问题
+- **商业面板** → 多专家战略分析
+- **深度研究** → 自主网络研究
+- **编排** → 高效工具协调
+- **令牌效率** → 30-50%上下文节省
+- **任务管理** → 系统化组织
+- **内省** → 元认知分析
+
+ |
+
+
|
### 📚 **文档全面改写**
@@ -251,6 +293,16 @@ pip install --break-system-packages SuperClaude
- 包含实用工作流
- 更好的导航结构
+ |
+
+
+### 🧪 **增强稳定性**
+**专注于可靠性：**
+- 核心命令的错误修复
+- 改进测试覆盖率
+- 更健壮的错误处理
+- CI/CD流水线改进
+
|
@@ -261,9 +313,101 @@ pip install --break-system-packages SuperClaude
-## 📚 **Documentation**
+## 🔬 **深度研究能力**
-### **Complete Guide to SuperClaude**
+### **与DR智能体架构一致的自主网络研究**
+
+SuperClaude v4.2引入了全面的深度研究能力，实现自主、自适应和智能的网络研究。
+
+
+
+|
+
+### 🎯 **自适应规划**
+**三种智能策略：**
+- **仅规划**：对明确查询直接执行
+- **意图规划**：对模糊请求进行澄清
+- **统一**：协作式计划完善(默认)
+
+ |
+
+
+### 🔄 **多跳推理**
+**最多5次迭代搜索：**
+- 实体扩展(论文 → 作者 → 作品)
+- 概念深化(主题 → 细节 → 示例)
+- 时间进展(当前 → 历史)
+- 因果链(效果 → 原因 → 预防)
+
+ |
+
+
+|
+
+### 📊 **质量评分**
+**基于置信度的验证：**
+- 来源可信度评估(0.0-1.0)
+- 覆盖完整性跟踪
+- 综合连贯性评估
+- 最低阈值：0.6，目标：0.8
+
+ |
+
+
+### 🧠 **基于案例的学习**
+**跨会话智能：**
+- 模式识别和重用
+- 随时间优化策略
+- 保存成功的查询公式
+- 性能改进跟踪
+
+ |
+
+
+
+### **研究命令使用**
+
+```bash
+# 使用自动深度的基本研究
+/research "2024年最新AI发展"
+
+# 控制研究深度(通过TypeScript中的选项)
+/research "量子计算突破" # depth: exhaustive
+
+# 特定策略选择
+/research "市场分析" # strategy: planning-only
+
+# 领域过滤研究(Tavily MCP集成)
+/research "React模式" # domains: reactjs.org,github.com
+```
+
+### **研究深度级别**
+
+| 深度 | 来源 | 跳数 | 时间 | 最适合 |
+|:-----:|:-------:|:----:|:----:|----------|
+| **快速** | 5-10 | 1 | ~2分钟 | 快速事实、简单查询 |
+| **标准** | 10-20 | 3 | ~5分钟 | 一般研究(默认) |
+| **深入** | 20-40 | 4 | ~8分钟 | 综合分析 |
+| **详尽** | 40+ | 5 | ~10分钟 | 学术级研究 |
+
+### **集成工具编排**
+
+深度研究系统智能协调多个工具：
+- **Tavily MCP**：主要网络搜索和发现
+- **Playwright MCP**：复杂内容提取
+- **Sequential MCP**：多步推理和综合
+- **Serena MCP**：内存和学习持久化
+- **Context7 MCP**：技术文档查找
+
+
+
+---
+
+
+
+## 📚 **文档**
+
+### **SuperClaude完整指南**
@@ -275,55 +419,52 @@ pip install --break-system-packages SuperClaude
|
-- 📝 [**快速开始指南**](docs/getting-started/quick-start.md)
+- 📝 [**快速开始指南**](docs/getting-started/quick-start.md)
*快速上手使用*
-- 💾 [**安装指南**](docs/getting-started/installation.md)
+- 💾 [**安装指南**](docs/getting-started/installation.md)
*详细的安装说明*
|
-- 🎯 [**命令参考**](docs/user-guide-zh/commands.md)
- *全部21个斜杠命令*
+- 🎯 [**斜杠命令**](docs/user-guide/commands.md)
+ *完整的 `/sc` 命令列表*
-- 🤖 [**智能体指南**](docs/user-guide-zh/agents.md)
- *14个专业智能体*
+- 🤖 [**智能体指南**](docs/user-guide/agents.md)
+ *16个专业智能体*
-- 🎨 [**行为模式**](docs/user-guide-zh/modes.md)
- *5种自适应模式*
+- 🎨 [**行为模式**](docs/user-guide/modes.md)
+ *7种自适应模式*
-- 🚩 [**标志指南**](docs/user-guide-zh/flags.md)
+- 🚩 [**标志指南**](docs/user-guide/flags.md)
*控制行为参数*
-- 🔧 [**MCP服务器**](docs/user-guide-zh/mcp-servers.md)
- *6个服务器集成*
+- 🔧 [**MCP服务器**](docs/user-guide/mcp-servers.md)
+ *8个服务器集成*
-- 💼 [**会话管理**](docs/user-guide-zh/session-management.md)
+- 💼 [**会话管理**](docs/user-guide/session-management.md)
*保存和恢复状态*
|
-- 🏗️ [**技术架构**](docs/developer-guide/technical-architecture.md)
+- 🏗️ [**技术架构**](docs/developer-guide/technical-architecture.md)
*系统设计详情*
-- 💻 [**贡献代码**](docs/developer-guide/contributing-code.md)
+- 💻 [**贡献代码**](docs/developer-guide/contributing-code.md)
*开发工作流程*
-- 🧪 [**测试与调试**](docs/developer-guide/testing-debugging.md)
+- 🧪 [**测试与调试**](docs/developer-guide/testing-debugging.md)
*质量保证*
|
-- ✨ [**最佳实践**](docs/reference/basic-examples.md)
- *专业技巧和模式*
-
-- 📓 [**示例手册**](docs/reference/examples-cookbook.md)
+- 📓 [**示例手册**](docs/reference/examples-cookbook.md)
*实际应用示例*
-- 🔍 [**故障排除**](docs/reference/troubleshooting.md)
+- 🔍 [**故障排除**](docs/reference/troubleshooting.md)
*常见问题和修复*
|