SuperClaude/README-zh.md

608 lines
16 KiB
Markdown
Raw Permalink Normal View History

<div align="center">
# 🚀 SuperClaude 框架
### **将Claude Code转换为结构化开发平台**
<p align="center">
<img src="https://img.shields.io/badge/version-4.1.9-blue" alt="Version">
<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License">
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome">
</p>
<p align="center">
<a href="https://superclaude.netlify.app/">
<img src="https://img.shields.io/badge/🌐_访问网站-blue" alt="Website">
</a>
refactor: PEP8 compliance - directory rename and code formatting (#425) * fix(orchestration): add WebFetch auto-trigger for infrastructure configuration Problem: Infrastructure configuration changes (e.g., Traefik port settings) were being made based on assumptions without consulting official documentation, violating the 'Evidence > assumptions' principle in PRINCIPLES.md. Solution: - Added Infrastructure Configuration Validation section to MODE_Orchestration.md - Auto-triggers WebFetch for infrastructure tools (Traefik, nginx, Docker, etc.) - Enforces MODE_DeepResearch activation for investigation - BLOCKS assumption-based configuration changes Testing: Verified WebFetch successfully retrieves Traefik official docs (port 80 default) This prevents production outages from infrastructure misconfiguration by ensuring all technical recommendations are backed by official documentation. * feat: Add PM Agent (Project Manager Agent) for seamless orchestration Introduces PM Agent as the default orchestration layer that coordinates all sub-agents and manages workflows automatically. Key Features: - Default orchestration: All user interactions handled by PM Agent - Auto-delegation: Intelligent sub-agent selection based on task analysis - Docker Gateway integration: Zero-token baseline with dynamic MCP loading - Self-improvement loop: Automatic documentation of patterns and mistakes - Optional override: Users can specify sub-agents explicitly if desired Architecture: - Agent spec: SuperClaude/Agents/pm-agent.md - Command: SuperClaude/Commands/pm.md - Updated docs: README.md (15→16 agents), agents.md (new Orchestration category) User Experience: - Default: PM Agent handles everything (seamless, no manual routing) - Optional: Explicit --agent flag for direct sub-agent access - Both modes available simultaneously (no user downside) Implementation Status: - ✅ Specification complete - ✅ Documentation complete - ⏳ Prototype implementation needed - ⏳ Docker Gateway integration needed - ⏳ Testing and validation needed Refs: kazukinakai/docker-mcp-gateway (IRIS MCP Gateway integration) * feat: Add Agent Orchestration rules for PM Agent default activation Implements PM Agent as the default orchestration layer in RULES.md. Key Changes: - New 'Agent Orchestration' section (CRITICAL priority) - PM Agent receives ALL user requests by default - Manual override with @agent-[name] bypasses PM Agent - Agent Selection Priority clearly defined: 1. Manual override → Direct routing 2. Default → PM Agent → Auto-delegation 3. Delegation based on keywords, file types, complexity, context User Experience: - Default: PM Agent handles everything (seamless) - Override: @agent-[name] for direct specialist access - Transparent: PM Agent reports delegation decisions This establishes PM Agent as the orchestration layer while respecting existing auto-activation patterns and manual overrides. Next Steps: - Local testing in agiletec project - Iteration based on actual behavior - Documentation updates as needed * refactor(pm-agent): redesign as self-improvement meta-layer Problem Resolution: PM Agent's initial design competed with existing auto-activation for task routing, creating confusion about orchestration responsibilities and adding unnecessary complexity. Design Change: Redefined PM Agent as a meta-layer agent that operates AFTER specialist agents complete tasks, focusing on: - Post-implementation documentation and pattern recording - Immediate mistake analysis with prevention checklists - Monthly documentation maintenance and noise reduction - Pattern extraction and knowledge synthesis Two-Layer Orchestration System: 1. Task Execution Layer: Existing auto-activation handles task routing (unchanged) 2. Self-Improvement Layer: PM Agent meta-layer handles documentation (new) Files Modified: - SuperClaude/Agents/pm-agent.md: Complete rewrite with meta-layer design - Category: orchestration → meta - Triggers: All user interactions → Post-implementation, mistakes, monthly - Behavioral Mindset: Continuous learning system - Self-Improvement Workflow: BEFORE/DURING/AFTER/MISTAKE RECOVERY/MAINTENANCE - SuperClaude/Core/RULES.md: Agent Orchestration section updated - Split into Task Execution Layer + Self-Improvement Layer - Added orchestration flow diagram - Clarified PM Agent activates AFTER task completion - README.md: Updated PM Agent description - "orchestrates all interactions" → "ensures continuous learning" - Docs/User-Guide/agents.md: PM Agent section rewritten - Section: Orchestration Agent → Meta-Layer Agent - Expertise: Project orchestration → Self-improvement workflow executor - Examples: Task coordination → Post-implementation documentation - PR_DOCUMENTATION.md: Comprehensive PR documentation added - Summary, motivation, changes, testing, breaking changes - Two-layer orchestration system diagram - Verification checklist Integration Validated: Tested with agiletec project's self-improvement-workflow.md: ✅ PM Agent aligns with existing BEFORE/DURING/AFTER/MISTAKE RECOVERY phases ✅ Complements (not competes with) existing workflow ✅ agiletec workflow defines WHAT, PM Agent defines WHO executes it Breaking Changes: None - Existing auto-activation continues unchanged - Specialist agents unaffected - User workflows remain the same - New capability: Automatic documentation and knowledge maintenance Value Proposition: Transforms SuperClaude into a continuously learning system that accumulates knowledge, prevents recurring mistakes, and maintains fresh documentation without manual intervention. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * docs: add Claude Code conversation history management research Research covering .jsonl file structure, performance impact, and retention policies. Content: - Claude Code .jsonl file format and message types - Performance issues from GitHub (memory leaks, conversation compaction) - Retention policies (consumer vs enterprise) - Rotation recommendations based on actual data - File history snapshot tracking mechanics Source: Moved from agiletec project (research applicable to all Claude Code projects) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: add Development documentation structure Phase 1: Documentation Structure complete - Add Docs/Development/ directory for development documentation - Add ARCHITECTURE.md - System architecture with PM Agent meta-layer - Add ROADMAP.md - 5-phase development plan with checkboxes - Add TASKS.md - Daily task tracking with progress indicators - Add PROJECT_STATUS.md - Current status dashboard and metrics - Add pm-agent-integration.md - Implementation guide for PM Agent mode This establishes comprehensive documentation foundation for: - System architecture understanding - Development planning and tracking - Implementation guidance - Progress visibility Related: #pm-agent-mode #documentation #phase-1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat: PM Agent session lifecycle and PDCA implementation Phase 2: PM Agent Mode Integration (Design Phase) Commands/pm.md updates: - Add "Always-Active Foundation Layer" concept - Add Session Lifecycle (Session Start/During Work/Session End) - Add PDCA Cycle (Plan/Do/Check/Act) automation - Add Serena MCP Memory Integration (list/read/write_memory) - Document auto-activation triggers Agents/pm-agent.md updates: - Add Session Start Protocol (MANDATORY auto-activation) - Add During Work PDCA Cycle with example workflows - Add Session End Protocol with state preservation - Add PDCA Self-Evaluation Pattern - Add Documentation Strategy (temp → patterns/mistakes) - Add Memory Operations Reference Key Features: - Session start auto-activation for context restoration - 30-minute checkpoint saves during work - Self-evaluation with think_about_* operations - Systematic documentation lifecycle - Knowledge evolution to CLAUDE.md Implementation Status: - ✅ Design complete (Commands/pm.md, Agents/pm-agent.md) - ⏳ Implementation pending (Core components) - ⏳ Serena MCP integration pending Salvaged from mistaken development in ~/.claude directory Related: #pm-agent-mode #session-lifecycle #pdca-cycle #phase-2 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: disable Serena MCP auto-browser launch Disable web dashboard and GUI log window auto-launch in Serena MCP server to prevent intrusive browser popups on startup. Users can still manually access the dashboard at http://localhost:24282/dashboard/ if needed. Changes: - Add CLI flags to Serena run command: - --enable-web-dashboard false - --enable-gui-log-window false - Ensures Git-tracked configuration (no reliance on ~/.serena/serena_config.yml) - Aligns with AIRIS MCP Gateway integration approach 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: rename directories to lowercase for PEP8 compliance - Rename superclaude/Agents -> superclaude/agents - Rename superclaude/Commands -> superclaude/commands - Rename superclaude/Core -> superclaude/core - Rename superclaude/Examples -> superclaude/examples - Rename superclaude/MCP -> superclaude/mcp - Rename superclaude/Modes -> superclaude/modes This change follows Python PEP8 naming conventions for package directories. * style: fix PEP8 violations and update package name to lowercase Changes: - Format all Python files with black (43 files reformatted) - Update package name from 'SuperClaude' to 'superclaude' in pyproject.toml - Fix import statements to use lowercase package name - Add missing imports (timedelta, __version__) - Remove old SuperClaude.egg-info directory PEP8 violations reduced from 2672 to 701 (mostly E501 line length due to black's 88 char vs flake8's 79 char limit). * docs: add PM Agent development documentation Add comprehensive PM Agent development documentation: - PM Agent ideal workflow (7-phase autonomous cycle) - Project structure understanding (Git vs installed environment) - Installation flow understanding (CommandsComponent behavior) - Task management system (current-tasks.md) Purpose: Eliminate repeated explanations and enable autonomous PDCA cycles 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat(pm-agent): add self-correcting execution and warning investigation culture ## Changes ### superclaude/commands/pm.md - Add "Self-Correcting Execution" section with root cause analysis protocol - Add "Warning/Error Investigation Culture" section enforcing zero-tolerance for dismissal - Define error detection protocol: STOP → Investigate → Hypothesis → Different Solution → Execute - Document anti-patterns (retry without understanding) and correct patterns (research-first) ### docs/Development/hypothesis-pm-autonomous-enhancement-2025-10-14.md - Add PDCA workflow hypothesis document for PM Agent autonomous enhancement ## Rationale PM Agent must never retry failed operations without understanding root causes. All warnings and errors require investigation via context7/WebFetch/documentation to ensure production-quality code and prevent technical debt accumulation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * feat(installer): add airis-mcp-gateway MCP server option ## Changes - Add airis-mcp-gateway to MCP server options in installer - Configuration: GitHub-based installation via uvx - Repository: https://github.com/oraios/airis-mcp-gateway - Purpose: Dynamic MCP Gateway for zero-token baseline and on-demand tool loading ## Implementation Added to setup/components/mcp.py self.mcp_servers dictionary with: - install_method: github - install_command: uvx test installation - run_command: uvx runtime execution - required: False (optional server) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local> Co-authored-by: Claude <noreply@anthropic.com>
2025-10-14 12:17:09 +09:00
<a href="https://pypi.org/project/superclaude/">
<img src="https://img.shields.io/pypi/v/SuperClaude.svg?" alt="PyPI">
</a>
<a href="https://www.npmjs.com/package/@bifrost_inc/superclaude">
<img src="https://img.shields.io/npm/v/@bifrost_inc/superclaude.svg" alt="npm">
</a>
</p>
<!-- Language Selector -->
<p align="center">
<a href="README.md">
<img src="https://img.shields.io/badge/🇺🇸_English-blue" alt="English">
</a>
<a href="README-zh.md">
<img src="https://img.shields.io/badge/🇨🇳_中文-red" alt="中文">
</a>
<a href="README-ja.md">
<img src="https://img.shields.io/badge/🇯🇵_日本語-green" alt="日本語">
</a>
</p>
<p align="center">
<a href="#-快速安装">快速开始</a>
<a href="#-支持项目">支持项目</a>
<a href="#-v4版本新功能">新功能</a>
<a href="#-文档">文档</a>
<a href="#-贡献">贡献</a>
</p>
</div>
---
<div align="center">
## 📊 **框架统计**
feat: restore all 30 slash commands with comprehensive documentation Restored 26 additional commands from commit d4a17fc, bringing total from 5 to 30 commands. ## New Commands Added (26): - /analyze - Code and architecture analysis - /brainstorm - Structured brainstorming sessions - /build - Build and compilation workflows - /business-panel - Multi-expert business analysis - /cleanup - Code cleanup and refactoring - /design - System design and architecture - /document - Documentation generation - /estimate - Effort and time estimation - /explain - Code explanation - /git - Git operations and workflows - /help - Command help and usage - /implement - Implementation workflows - /improve - Code improvement suggestions - /index - Project indexing (alias for index-repo) - /load - Load saved sessions - /pm - Project management workflows - /reflect - Reflection and retrospectives - /save - Save current session - /select-tool - Tool selection guidance - /spawn - Spawn parallel tasks - /spec-panel - Multi-expert specification analysis - /task - Task management - /test - Testing workflows - /troubleshoot - Debugging and troubleshooting - /workflow - Custom workflow automation ## Documentation Updates: - Created docs/reference/commands-list.md with categorized command reference - Updated README.md with expandable 30-command list - Updated README-zh.md with Chinese translations - Updated README-ja.md with Japanese translations - Updated README-kr.md with Korean translations - Changed statistics: "3 plugins" → "30 commands" - Added command categories: Planning & Design, Development, Testing & Quality, Documentation, Version Control, Project Management, Research & Analysis, Utilities ## Files Changed: - 60 files changed, 7930 insertions(+), 267 deletions(-) - Added 26 commands to plugins/superclaude/commands/ - Added 26 commands to src/superclaude/commands/ - Created comprehensive command documentation Commands restored from: d4a17fc (superclaude/commands/) Total: 30 commands now available 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-13 15:54:16 +01:00
| **命令** | **智能体** | **模式** | **MCP服务器** |
|:------------:|:----------:|:---------:|:---------------:|
feat: restore all 30 slash commands with comprehensive documentation Restored 26 additional commands from commit d4a17fc, bringing total from 5 to 30 commands. ## New Commands Added (26): - /analyze - Code and architecture analysis - /brainstorm - Structured brainstorming sessions - /build - Build and compilation workflows - /business-panel - Multi-expert business analysis - /cleanup - Code cleanup and refactoring - /design - System design and architecture - /document - Documentation generation - /estimate - Effort and time estimation - /explain - Code explanation - /git - Git operations and workflows - /help - Command help and usage - /implement - Implementation workflows - /improve - Code improvement suggestions - /index - Project indexing (alias for index-repo) - /load - Load saved sessions - /pm - Project management workflows - /reflect - Reflection and retrospectives - /save - Save current session - /select-tool - Tool selection guidance - /spawn - Spawn parallel tasks - /spec-panel - Multi-expert specification analysis - /task - Task management - /test - Testing workflows - /troubleshoot - Debugging and troubleshooting - /workflow - Custom workflow automation ## Documentation Updates: - Created docs/reference/commands-list.md with categorized command reference - Updated README.md with expandable 30-command list - Updated README-zh.md with Chinese translations - Updated README-ja.md with Japanese translations - Updated README-kr.md with Korean translations - Changed statistics: "3 plugins" → "30 commands" - Added command categories: Planning & Design, Development, Testing & Quality, Documentation, Version Control, Project Management, Research & Analysis, Utilities ## Files Changed: - 60 files changed, 7930 insertions(+), 267 deletions(-) - Added 26 commands to plugins/superclaude/commands/ - Added 26 commands to src/superclaude/commands/ - Created comprehensive command documentation Commands restored from: d4a17fc (superclaude/commands/) Total: 30 commands now available 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-13 15:54:16 +01:00
| **30** | **16** | **7** | **8** |
| 斜杠命令 | 专业AI | 行为模式 | 集成服务 |
feat: restore all 30 slash commands with comprehensive documentation Restored 26 additional commands from commit d4a17fc, bringing total from 5 to 30 commands. ## New Commands Added (26): - /analyze - Code and architecture analysis - /brainstorm - Structured brainstorming sessions - /build - Build and compilation workflows - /business-panel - Multi-expert business analysis - /cleanup - Code cleanup and refactoring - /design - System design and architecture - /document - Documentation generation - /estimate - Effort and time estimation - /explain - Code explanation - /git - Git operations and workflows - /help - Command help and usage - /implement - Implementation workflows - /improve - Code improvement suggestions - /index - Project indexing (alias for index-repo) - /load - Load saved sessions - /pm - Project management workflows - /reflect - Reflection and retrospectives - /save - Save current session - /select-tool - Tool selection guidance - /spawn - Spawn parallel tasks - /spec-panel - Multi-expert specification analysis - /task - Task management - /test - Testing workflows - /troubleshoot - Debugging and troubleshooting - /workflow - Custom workflow automation ## Documentation Updates: - Created docs/reference/commands-list.md with categorized command reference - Updated README.md with expandable 30-command list - Updated README-zh.md with Chinese translations - Updated README-ja.md with Japanese translations - Updated README-kr.md with Korean translations - Changed statistics: "3 plugins" → "30 commands" - Added command categories: Planning & Design, Development, Testing & Quality, Documentation, Version Control, Project Management, Research & Analysis, Utilities ## Files Changed: - 60 files changed, 7930 insertions(+), 267 deletions(-) - Added 26 commands to plugins/superclaude/commands/ - Added 26 commands to src/superclaude/commands/ - Created comprehensive command documentation Commands restored from: d4a17fc (superclaude/commands/) Total: 30 commands now available 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-13 15:54:16 +01:00
30个斜杠命令覆盖从头脑风暴到部署的完整开发生命周期。
</div>
---
<div align="center">
## 🎯 **概述**
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的
> 当前安装说明操作。
### **当前稳定版本 (v4.1.9)**
SuperClaude目前使用斜杠命令。
**选项1pipx推荐**
```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 ⚡
</div>
---
<div align="center">
## 💖 **支持项目**
> 说实话维护SuperClaude需要时间和资源。
>
> *仅Claude Max订阅每月就要100美元用于测试这还不包括在文档、bug修复和功能开发上花费的时间。*
> *如果您在日常工作中发现SuperClaude的价值请考虑支持这个项目。*
> *哪怕几美元也能帮助覆盖基础成本并保持开发活跃。*
>
> 每个贡献者都很重要,无论是代码、反馈还是支持。感谢成为这个社区的一员!🙏
<table>
<tr>
<td align="center" width="33%">
### ☕ **Ko-fi**
[![Ko-fi](https://img.shields.io/badge/Support_on-Ko--fi-ff5e5b?logo=ko-fi)](https://ko-fi.com/superclaude)
*一次性贡献*
</td>
<td align="center" width="33%">
### 🎯 **Patreon**
[![Patreon](https://img.shields.io/badge/Become_a-Patron-f96854?logo=patreon)](https://patreon.com/superclaude)
*月度支持*
</td>
<td align="center" width="33%">
### 💜 **GitHub**
[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsor-30363D?logo=github-sponsors)](https://github.com/sponsors/SuperClaude-Org)
*灵活层级*
</td>
</tr>
</table>
### **您的支持使以下工作成为可能:**
| 项目 | 成本/影响 |
|------|-------------|
| 🔬 **Claude Max测试** | 每月100美元用于验证和测试 |
| ⚡ **功能开发** | 新功能和改进 |
| 📚 **文档编写** | 全面的指南和示例 |
| 🤝 **社区支持** | 快速问题响应和帮助 |
| 🔧 **MCP集成** | 测试新服务器连接 |
| 🌐 **基础设施** | 托管和部署成本 |
> **注意:** 不过没有压力——无论如何框架都会保持开源。仅仅知道有人在使用和欣赏它就很有激励作用。贡献代码、文档或传播消息也很有帮助!🙏
</div>
---
<div align="center">
## 🎉 **V4.1版本新功能**
> *版本4.1专注于稳定斜杠命令架构、增强智能体能力和改进文档。*
<table>
<tr>
<td width="50%">
### 🤖 **更智能的智能体系统**
**16个专业智能体**具有领域专业知识:
- PM Agent通过系统化文档确保持续学习
- 深度研究智能体用于自主网络研究
- 安全工程师发现真实漏洞
- 前端架构师理解UI模式
- 基于上下文的自动协调
- 按需提供领域专业知识
</td>
<td width="50%">
### ⚡ **优化性能**
**更小的框架,更大的项目:**
- 减少框架占用
- 为您的代码提供更多上下文
- 支持更长对话
- 启用复杂操作
</td>
</tr>
<tr>
<td width="50%">
### 🔧 **MCP服务器集成**
**8个强大服务器**(通过airis-mcp-gateway)
- **Tavily** → 主要网络搜索(深度研究)
- **Serena** → 会话持久化和内存
- **Mindbase** → 跨会话学习(零占用)
- **Sequential** → Token高效推理
- **Context7** → 官方文档查找
- **Playwright** → JavaScript重度内容提取
- **Magic** → UI组件生成
- **Chrome DevTools** → 性能分析
</td>
<td width="50%">
### 🎯 **行为模式**
**7种自适应模式**适应不同上下文:
- **头脑风暴** → 提出正确问题
- **商业面板** → 多专家战略分析
- **深度研究** → 自主网络研究
- **编排** → 高效工具协调
- **令牌效率** → 30-50%上下文节省
- **任务管理** → 系统化组织
- **内省** → 元认知分析
</td>
</tr>
<tr>
<td width="50%">
### 📚 **文档全面改写**
**为开发者完全重写:**
- 真实示例和用例
- 记录常见陷阱
- 包含实用工作流
- 更好的导航结构
</td>
<td width="50%">
### 🧪 **增强稳定性**
**专注于可靠性:**
- 核心命令的错误修复
- 改进测试覆盖率
- 更健壮的错误处理
- CI/CD流水线改进
</td>
</tr>
</table>
</div>
---
<div align="center">
## 🔬 **深度研究能力**
### **与DR智能体架构一致的自主网络研究**
SuperClaude v4.2引入了全面的深度研究能力,实现自主、自适应和智能的网络研究。
<table>
<tr>
<td width="50%">
### 🎯 **自适应规划**
**三种智能策略:**
- **仅规划**:对明确查询直接执行
- **意图规划**:对模糊请求进行澄清
- **统一**:协作式计划完善(默认)
</td>
<td width="50%">
### 🔄 **多跳推理**
**最多5次迭代搜索**
- 实体扩展(论文 → 作者 → 作品)
- 概念深化(主题 → 细节 → 示例)
- 时间进展(当前 → 历史)
- 因果链(效果 → 原因 → 预防)
</td>
</tr>
<tr>
<td width="50%">
### 📊 **质量评分**
**基于置信度的验证:**
- 来源可信度评估(0.0-1.0)
- 覆盖完整性跟踪
- 综合连贯性评估
- 最低阈值0.6目标0.8
</td>
<td width="50%">
### 🧠 **基于案例的学习**
**跨会话智能:**
- 模式识别和重用
- 随时间优化策略
- 保存成功的查询公式
- 性能改进跟踪
</td>
</tr>
</table>
### **研究命令使用**
```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**:技术文档查找
</div>
---
<div align="center">
## 📚 **文档**
### **SuperClaude完整指南**
<table>
<tr>
<th align="center">🚀 快速开始</th>
<th align="center">📖 用户指南</th>
<th align="center">🛠️ 开发资源</th>
<th align="center">📋 参考资料</th>
</tr>
<tr>
<td valign="top">
- 📝 [**快速开始指南**](docs/getting-started/quick-start.md)
*快速上手使用*
- 💾 [**安装指南**](docs/getting-started/installation.md)
*详细的安装说明*
</td>
<td valign="top">
- 🎯 [**斜杠命令**](docs/user-guide/commands.md)
*完整的 `/sc` 命令列表*
- 🤖 [**智能体指南**](docs/user-guide/agents.md)
*16个专业智能体*
- 🎨 [**行为模式**](docs/user-guide/modes.md)
*7种自适应模式*
- 🚩 [**标志指南**](docs/user-guide/flags.md)
*控制行为参数*
- 🔧 [**MCP服务器**](docs/user-guide/mcp-servers.md)
*8个服务器集成*
- 💼 [**会话管理**](docs/user-guide/session-management.md)
*保存和恢复状态*
</td>
<td valign="top">
- 🏗️ [**技术架构**](docs/developer-guide/technical-architecture.md)
*系统设计详情*
- 💻 [**贡献代码**](docs/developer-guide/contributing-code.md)
*开发工作流程*
- 🧪 [**测试与调试**](docs/developer-guide/testing-debugging.md)
*质量保证*
</td>
<td valign="top">
- 📓 [**示例手册**](docs/reference/examples-cookbook.md)
*实际应用示例*
- 🔍 [**故障排除**](docs/reference/troubleshooting.md)
*常见问题和修复*
</td>
</tr>
</table>
</div>
---
<div align="center">
## 🤝 **贡献**
### **加入SuperClaude社区**
我们欢迎各种类型的贡献!以下是您可以帮助的方式:
| 优先级 | 领域 | 描述 |
|:--------:|------|-------------|
| 📝 **高** | 文档 | 改进指南,添加示例,修复错误 |
| 🔧 **高** | MCP集成 | 添加服务器配置,测试集成 |
| 🎯 **中** | 工作流 | 创建命令模式和配方 |
| 🧪 **中** | 测试 | 添加测试,验证功能 |
| 🌐 **低** | 国际化 | 将文档翻译为其他语言 |
<p align="center">
<a href="CONTRIBUTING.md">
<img src="https://img.shields.io/badge/📖_阅读-贡献指南-blue" alt="Contributing Guide">
</a>
<a href="https://github.com/SuperClaude-Org/SuperClaude_Framework/graphs/contributors">
<img src="https://img.shields.io/badge/👥_查看-所有贡献者-green" alt="Contributors">
</a>
</p>
</div>
---
<div align="center">
## ⚖️ **许可证**
本项目基于**MIT许可证**授权 - 详情请参阅[LICENSE](LICENSE)文件。
<p align="center">
<img src="https://img.shields.io/badge/License-MIT-yellow.svg?" alt="MIT License">
</p>
</div>
---
<div align="center">
## ⭐ **Star历史**
<a href="https://www.star-history.com/#SuperClaude-Org/SuperClaude_Framework&Timeline">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=SuperClaude-Org/SuperClaude_Framework&type=Timeline" />
</picture>
</a>
</div>
---
<div align="center">
### **🚀 由SuperClaude社区倾情打造**
<p align="center">
<sub>为突破边界的开发者用❤️制作</sub>
</p>
<p align="center">
<a href="#-superclaude-框架">返回顶部 ↑</a>
</p>
</div>
feat: restore all 30 slash commands with comprehensive documentation Restored 26 additional commands from commit d4a17fc, bringing total from 5 to 30 commands. ## New Commands Added (26): - /analyze - Code and architecture analysis - /brainstorm - Structured brainstorming sessions - /build - Build and compilation workflows - /business-panel - Multi-expert business analysis - /cleanup - Code cleanup and refactoring - /design - System design and architecture - /document - Documentation generation - /estimate - Effort and time estimation - /explain - Code explanation - /git - Git operations and workflows - /help - Command help and usage - /implement - Implementation workflows - /improve - Code improvement suggestions - /index - Project indexing (alias for index-repo) - /load - Load saved sessions - /pm - Project management workflows - /reflect - Reflection and retrospectives - /save - Save current session - /select-tool - Tool selection guidance - /spawn - Spawn parallel tasks - /spec-panel - Multi-expert specification analysis - /task - Task management - /test - Testing workflows - /troubleshoot - Debugging and troubleshooting - /workflow - Custom workflow automation ## Documentation Updates: - Created docs/reference/commands-list.md with categorized command reference - Updated README.md with expandable 30-command list - Updated README-zh.md with Chinese translations - Updated README-ja.md with Japanese translations - Updated README-kr.md with Korean translations - Changed statistics: "3 plugins" → "30 commands" - Added command categories: Planning & Design, Development, Testing & Quality, Documentation, Version Control, Project Management, Research & Analysis, Utilities ## Files Changed: - 60 files changed, 7930 insertions(+), 267 deletions(-) - Added 26 commands to plugins/superclaude/commands/ - Added 26 commands to src/superclaude/commands/ - Created comprehensive command documentation Commands restored from: d4a17fc (superclaude/commands/) Total: 30 commands now available 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-13 15:54:16 +01:00
---
## 📋 **全部30个命令**
<details>
<summary><b>点击展开完整命令列表</b></summary>
### 🧠 规划与设计 (4)
- `/brainstorm` - 结构化头脑风暴
- `/design` - 系统架构
- `/estimate` - 时间/工作量估算
- `/spec-panel` - 规格分析
### 💻 开发 (5)
- `/implement` - 代码实现
- `/build` - 构建工作流
- `/improve` - 代码改进
- `/cleanup` - 重构
- `/explain` - 代码解释
### 🧪 测试与质量 (4)
- `/test` - 测试生成
- `/analyze` - 代码分析
- `/troubleshoot` - 调试
- `/reflect` - 回顾
### 📚 文档 (2)
- `/document` - 文档生成
- `/help` - 命令帮助
### 🔧 版本控制 (1)
- `/git` - Git操作
### 📊 项目管理 (3)
- `/pm` - 项目管理
- `/task` - 任务跟踪
- `/workflow` - 工作流自动化
### 🔍 研究与分析 (2)
- `/research` - 深度网络研究
- `/business-panel` - 业务分析
### 🎯 实用工具 (9)
- `/agent` - AI智能体
- `/index-repo` - 仓库索引
- `/index` - 索引别名
- `/recommend` - 命令推荐
- `/select-tool` - 工具选择
- `/spawn` - 并行任务
- `/load` - 加载会话
- `/save` - 保存会话
- `/sc` - 显示所有命令
[**📖 查看详细命令参考 →**](docs/reference/commands-list.md)
</details>