mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-17 17:56:46 +00:00

* Fix: Install only selected MCP servers and ensure valid empty backups

This commit addresses two separate issues:

1.  **MCP Installation:** The `install` command was installing all MCP servers instead of only the ones selected by the user. The `_install` method in `setup/components/mcp.py` was iterating through all available servers, not the user's selection. This has been fixed to respect the `selected_mcp_servers` configuration. A new test has been added to verify this fix.

2.  **Backup Creation:** The `create_backup` method in `setup/core/installer.py` created an invalid `.tar.gz` file when the backup source was empty. This has been fixed to ensure that a valid, empty tar archive is always created. A test was added for this as well.
Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Fix: Correct installer validation for MCP and MCP Docs components

This commit fixes a validation issue in the installer where it would incorrectly fail after a partial installation of MCP servers.

The `MCPComponent` validation logic was checking for all "required" servers, regardless of whether they were selected by the user. This has been corrected to only validate the servers that were actually installed, by checking against the list of installed servers stored in the metadata. The metadata storage has also been fixed to only record the installed servers.

The `MCPDocsComponent` was failing validation because it was not being registered in the metadata if no documentation files were installed. This has been fixed by ensuring the post-installation hook runs even when no files are copied.

New tests have been added for both components to verify the corrected logic.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Fix: Allow re-installation of components and correct validation logic

This commit fixes a bug that prevented new MCP servers from being installed on subsequent runs of the installer. It also fixes the validation logic that was causing failures after a partial installation.

The key changes are:
1.  A new `is_reinstallable` method has been added to the base `Component` class. This allows certain components (like the `mcp` component) to be re-run even if they are already marked as installed.
2.  The installer logic has been updated to respect this new method.
3.  The `MCPComponent` now correctly stores only the installed servers in the metadata.
4.  The validation logic for `MCPComponent` and `MCPDocsComponent` has been corrected to prevent incorrect failures.

New tests have been added to verify all aspects of the new logic.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Display authors in UI header and update author info

This commit implements the user's request to display author names and emails in the UI header of the installer.

The key changes are:
1.  The `__email__` field in `SuperClaude/__init__.py` has been updated to include both authors' emails.
2.  The `display_header` function in `setup/utils/ui.py` has been modified to read the author and email information and display it.
3.  A new test has been added to `tests/test_ui.py` to verify the new UI output.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Version bump to 4.1.0 and various fixes

This commit prepares the project for the v4.1.0 release. It includes a version bump across all relevant files and incorporates several bug fixes and feature enhancements from recent tasks.

Key changes in this release:

- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 in all configuration files, documentation, and source code.

- **Installer Fixes**:
  - Components can now be marked as `reinstallable`, allowing them to be re-run on subsequent installations. This fixes a bug where new MCP servers could not be added.
  - The validation logic for `mcp` and `mcp_docs` components has been corrected to avoid incorrect failures.
  - A bug in the backup creation process that created invalid empty archives has been fixed.

- **UI Enhancements**:
  - Author names and emails are now displayed in the installer UI header.

- **Metadata Updates**:
  - Mithun Gowda B has been added as an author.

- **New Tests**:
  - Comprehensive tests have been added for the installer logic, MCP components, and UI changes to ensure correctness and prevent regressions.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* fix: Resolve dependencies for partial installs and other fixes

This commit addresses several issues, the main one being a dependency resolution failure during partial installations.

Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree when a user requests to install a subset of components. This fixes the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run on subsequent installs, enabling the addition of new servers.
- **Validation Logic**: The validation for `mcp` and `mcp_docs` has been corrected to avoid spurious failures.
- **UI and Metadata**: Author information has been added to the UI header and source files.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Tests**: New tests have been added to cover all the above changes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* fix: Installer fixes and version bump to 4.1.0

This commit includes a collection of fixes for the installer logic, UI enhancements, and a version bump to 4.1.0.

Key changes:
- **Dependency Resolution**: The installer now correctly resolves the full dependency tree for partial installations, fixing the "Unknown component: core" error.
- **Component Re-installation**: A new `is_reinstallable` flag allows components like `mcp` to be re-run to add new servers.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts the user to select servers.
- **Validation Logic**: The post-installation validation logic has been corrected to only validate components from the current session and to use the correct list of installed servers.
- **UI & Metadata**: Author information has been added to the UI and source files.
- **Version Bump**: The project version has been updated from 4.0.9 to 4.1.0 across all files.
- **Tests**: New tests have been added to cover all the bug fixes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* feat: Add --authors flag and multiple installer fixes

This commit introduces the `--authors` flag to display author information and includes a collection of fixes for the installer logic.

Key changes:
- **New Feature**: Added an `--authors` flag that displays the names, emails, and GitHub usernames of the project authors.
- **Dependency Resolution**: Fixed a critical bug where partial installations would fail due to unresolved dependencies.
- **Component Re-installation**: Added a mechanism to allow components to be "reinstallable", fixing an issue that prevented adding new MCP servers on subsequent runs.
- **MCP Installation**: The non-interactive installation of the `mcp` component now correctly prompts for server selection.
- **Validation Logic**: Corrected the post-installation validation to prevent spurious errors.
- **Version Bump**: The project version has been updated to 4.1.0.
- **Metadata**: Author and GitHub information has been added to the source files.
- **UI**: The installer header now displays author information.
- **Tests**: Added new tests for all new features and bug fixes.

Co-authored-by: Mithun Gowda B <mithungowda.b7411@gmail.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>

* Add Docker support and framework enhancements

- Add serena-docker.json MCP configuration
- Update MCP configs and installer components
- Enhance CLI commands with new functionality
- Add symbols utility for framework operations
- Improve UI and logging components

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Bump version from 4.1.1 to 4.1.2

- Update version across all package files
- Update documentation and README files
- Update Python module version strings
- Update feature configuration files

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Bump version from 4.1.2 to 4.1.3

- Update version across all package files
- Update documentation and README files
- Update Python module version strings
- Update feature configuration files

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Fix home directory detection for immutable distros

- Add get_home_directory() function to handle /var/home/$USER paths
- Support Fedora Silverblue, Universal Blue, and other immutable distros
- Replace all Path.home() calls throughout the setup system
- Add fallback methods for edge cases and compatibility
- Create test script for immutable distro validation

Fixes:
- Incorrect home path detection on immutable Linux distributions
- Installation failures on Fedora Silverblue/Universal Blue
- Issues with Claude Code configuration paths

Technical changes:
- New get_home_directory() in utils/environment.py
- Updated all CLI commands, validators, and core components
- Maintains backward compatibility with standard systems
- Robust fallback chain for edge cases

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Fix circular import and complete immutable distro support

- Move get_home_directory() to separate paths.py module
- Resolve circular import between environment.py and logger.py
- Update all import statements across the setup system
- Verify functionality with comprehensive testing

Technical changes:
- Created setup/utils/paths.py for path utilities
- Updated imports in all affected modules
- Maintains full backward compatibility
- Fixes installation on immutable distros

Testing completed:
- ✅ Basic home directory detection works
- ✅ Installation system integration works
- ✅ Environment utilities integration works
- ✅ Immutable distro logic validated

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
Co-Authored-By: Mithun Gowda B <mithungowda.b7411@gmail.com>

* Fix mcp_docs installation bugs

- Fix mcp_docs component incorrectly marking as installed when no MCP servers selected
- Add MCP server selection prompt when mcp_docs component is explicitly requested
- Return False instead of calling _post_install() when no servers selected or files found
- Add user-friendly warning when mcp_docs requested without server selection
- Remove mcp_docs from installation when no servers are available

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix MCP server name mapping for documentation files

- Add mapping for sequential-thinking -> MCP_Sequential.md
- Add mapping for morphllm-fast-apply -> MCP_Morphllm.md
- Ensures mcp_docs installation works with all MCP server naming conventions

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Enable mcp_docs component reinstallation

- Add is_reinstallable() method returning True to allow repeat installations
- Fixes issue where mcp_docs was skipped on subsequent installation attempts
- Enables users to change MCP server selections and update documentation

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix repeat installation issues for mcp_docs

- Ensure mcp component is auto-added when mcp_docs is selected with servers
- Fix component_files tracking to only include successfully copied files
- Ensures CLAUDE.md gets properly updated with MCP documentation imports
- Fixes issue where MCP servers weren't installed on repeat attempts

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix MCP component metadata tracking and debug logging

- Fix servers_count to track actually installed servers instead of total available
- Add installed_servers list to metadata for better tracking
- Add debug logging to trace component auto-addition
- Ensures MCP component appears properly in metadata when servers are installed

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix pyproject.toml license format and add missing classifier

- Fix license format from string to {text = "MIT"} format
- Add missing "License :: OSI Approved :: MIT License" classifier
- Fix indentation consistency in classifiers section
- Resolves setup.py installation errors and PEP 621 compliance

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Fix MCP incremental installation and auto-detection system

PROBLEM FIXED:
- MCP component only registered servers selected during current session
- mcp_docs component only installed docs for newly selected servers
- Users had to reinstall everything when adding new MCP servers
- Installation failed if no servers selected but servers existed

SOLUTION IMPLEMENTED:
- Add auto-detection of existing MCP servers from config files (.claude.json, claude_desktop_config.json)
- Add CLI detection via 'claude mcp list' output parsing
- Add smart server merging (existing + selected + previously installed)
- Add server name normalization for common variations
- Fix CLI logic to allow mcp_docs installation without server selection
- Add graceful error handling for corrupted configs

KEY FEATURES:
✅ Auto-detects existing MCP servers from multiple config locations
✅ Supports incremental installation (add new servers without breaking existing)
✅ Works with or without --install-dir argument
✅ Handles server name variations (sequential vs sequential-thinking, etc.)
✅ Maintains metadata persistence across installation sessions
✅ Graceful fallback when config files are corrupted
✅ Compatible with both interactive and non-interactive modes

TESTED SCENARIOS:
- Fresh installation with no MCP servers ✅
- Auto-detection with existing servers ✅
- Incremental server additions ✅
- Mixed mode (new + existing servers) ✅
- Error handling with corrupted configs ✅
- Default vs custom installation directories ✅
- Interactive vs command-line modes ✅

Files changed:
- setup/cli/commands/install.py: Allow mcp_docs auto-detection mode
- setup/components/mcp.py: Add comprehensive auto-detection logic
- setup/components/mcp_docs.py: Add auto-detection for documentation

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Integrate SuperClaude framework flags into help command

ENHANCEMENT:
- Add comprehensive flag documentation to /sc:help command
- Include all 25 SuperClaude framework flags with descriptions
- Organize flags into logical categories (Mode, MCP, Analysis, Execution, Output)
- Add practical usage examples showing flag combinations
- Include flag priority rules and precedence hierarchy

NEW SECTIONS ADDED:
✅ Mode Activation Flags (5 flags): --brainstorm, --introspect, --task-manage, --orchestrate, --token-efficient
✅ MCP Server Flags (8 flags): --c7, --seq, --magic, --morph, --serena, --play, --all-mcp, --no-mcp
✅ Analysis Depth Flags (3 flags): --think, --think-hard, --ultrathink
✅ Execution Control Flags (6 flags): --delegate, --concurrency, --loop, --iterations, --validate, --safe-mode
✅ Output Optimization Flags (3 flags): --uc, --scope, --focus
✅ Flag Priority Rules: Clear hierarchy and precedence guidelines
✅ Usage Examples: 4 practical examples showing real-world flag combinations

IMPACT:
- Users can now discover all SuperClaude capabilities from /sc:help
- Single source of truth for commands AND flags
- Improved discoverability of advanced features
- Clear guidance on flag usage and combinations
- Help content nearly doubled (68 → 148 lines) with valuable reference information

Files changed:
- SuperClaude/Commands/help.md: Integrate FLAGS.md content with structured tables and examples

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Remove non-existent commands from modes.md documentation

PROBLEM FIXED:
- Documentation contained references to fake/non-existent commands
- Commands like sc:fix, sc:simple-pix, sc:update, sc:develop, sc:modernize, sc:simple-fix don't exist in CLI
- Confusing users who try to use these commands and get errors
- Inconsistency between documentation and actual SuperClaude command availability

COMMANDS REMOVED/REPLACED:
❌ /sc:simple-fix → ✅ /sc:troubleshoot (real command)
❌ /sc:develop → ✅ /sc:implement (real command)
❌ /sc:modernize → ✅ /sc:improve (real command)

AFFECTED FILES:
- Docs/User-Guide/modes.md: Fixed all non-existent command references
- Docs/User-Guide-jp/modes.md: Fixed Japanese translation with same issues
- Docs/User-Guide-zh/modes.md: Fixed Chinese translation with same issues

VERIFICATION:
✅ All remaining /sc: commands verified to exist in SuperClaude/Commands/
✅ No more references to fake commands in any language version
✅ Examples now use only real, working SuperClaude commands
✅ User experience improved - no more confusion from non-working commands

REAL COMMANDS REFERENCED:
- /sc:analyze, /sc:brainstorm, /sc:help, /sc:implement
- /sc:improve, /sc:reflect, /sc:troubleshoot
- All verified to exist in CLI implementation

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

* Version bump to 4.1.4

CHANGELOG:
✅ Added comprehensive flag documentation to /sc:help command
✅ Fixed MCP incremental installation and auto-detection system
✅ Cleaned up documentation by removing non-existent commands
✅ Enhanced user experience with complete capability reference

VERSION UPDATES:
- Updated VERSION file: 4.1.3 → 4.1.4
- Updated pyproject.toml: 4.1.3 → 4.1.4
- Updated package.json: 4.1.3 → 4.1.4
- Updated all Python __init__.py fallback versions
- Updated all documentation references across all languages
- Updated setup/data/features.json component versions
- Updated CHANGELOG.md with comprehensive 4.1.4 release notes

SCOPE OF CHANGES:
📦 Core files: VERSION, pyproject.toml, package.json, __init__.py files
📚 Documentation: All .md files across English, Japanese, Chinese
🔧 Setup files: features.json, base.py version references
📝 Project files: README files, CHANGELOG, SECURITY, CONTRIBUTING

VERIFICATION:
✅ No remaining 4.1.3 references found
✅ 29 files now properly reference 4.1.4
✅ All language versions consistently updated
✅ Package metadata properly versioned for distribution

🤖 Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Jules <jules-ai-assistant@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Happy <yesreply@happy.engineering>

2025-09-20 14:08:42 +05:30

11 KiB

Raw Blame History

SuperClaude 命令指南

SuperClaude 为 Claude Code 提供 21 个命令：用于工作流的 /sc:* 命令和用于专家的 @agent-*。

命令类型

类型	使用位置	格式	示例
斜杠命令	Claude Code	`/sc:[command]`	`/sc:implement "feature"`
智能体	Claude Code	`@agent-[name]`	`@agent-security "review"`
安装命令	终端	`SuperClaude [command]`	`SuperClaude install`

快速测试

# 终端：验证安装
python3 -m SuperClaude --version
# Claude Code CLI 验证：claude --version

# Claude Code：测试命令
/sc:brainstorm "test project"    # 应该询问发现性问题
/sc:analyze README.md           # 应该提供分析

工作流：/sc:brainstorm "idea" → /sc:implement "feature" → /sc:test

🎯 理解 SuperClaude 命令

SuperClaude 如何工作

SuperClaude 提供行为上下文文件，Claude Code 通过读取这些文件来采用专门的行为。当您键入 /sc:implement 时，Claude Code 读取 implement.md 上下文文件并遵循其行为指令。

SuperClaude 命令不是由软件执行的 - 它们是上下文触发器，通过读取框架中的专门指令文件来修改 Claude Code 的行为。

命令类型：

斜杠命令 (/sc:*)：触发工作流模式和行为模式
智能体调用 (@agent-*)：手动激活特定领域专家
标志 (--think、--safe-mode)：修改命令行为和深度

上下文机制：

用户输入：您输入 /sc:implement "auth system"
上下文加载：Claude Code 读取 ~/.claude/SuperClaude/Commands/implement.md
行为采用：Claude 运用专业知识进行工具选择和验证
增强输出：带有安全考虑和最佳实践的结构化实现

关键要点：这通过上下文管理而不是传统的软件执行来创建复杂的开发工作流。

安装命令 vs 使用命令

🖥️ 终端命令 （实际 CLI 软件）：

SuperClaude install - 安装框架组件
SuperClaude update - 更新现有安装
SuperClaude uninstall - 卸载框架安装
python3 -m SuperClaude --version - 检查安装状态

💬 Claude Code 命令 （上下文触发器）：

/sc:brainstorm - 激活需求发现上下文
/sc:implement - 激活特性开发上下文
@agent-security - 激活安全专家上下文
所有命令仅在 Claude Code 聊天界面中工作

快速开始：尝试 /sc:brainstorm "your project idea" → /sc:implement "feature name" → /sc:test 体验核心工作流。

🧪 Testing Your Setup

🖥️ 终端验证（在终端/CMD 中运行）

# 验证 SuperClaude 是否正常工作（主要方法）
python3 -m SuperClaude --version
# 示例输出：SuperClaude 4.1.4

# Claude Code CLI 版本检查
claude --version

# 检查已安装的组件
python3 -m SuperClaude install --list-components | grep mcp
# 示例输出：显示已安装的 MCP 组件

💬 Claude Code 测试（在 Claude Code 聊天中输入）

# 测试基本 /sc: 命令
/sc:brainstorm "test project"
# 示例行为：开始交互式需求发现

# 测试命令帮助
/sc:help
# 示例行为：显示可用命令列表

如果测试失败：检查安装指南或故障排除

📝 Command Quick Reference

Command Type	Where to Run	Format	Purpose	Example
🖥️ 安装	终端/CMD	`SuperClaude [command]`	设置和维护	`SuperClaude install`
🔧 配置	终端/CMD	`python3 -m SuperClaude [command]`	高级配置	`python3 -m SuperClaude --version`
💬 斜杠命令	Claude Code	`/sc:[command]`	工作流自动化	`/sc:implement "feature"`
🤖 智能体调用	Claude Code	`@agent-[name]`	手动专家激活	`@agent-security "review"`
⚡ 增强标志	Claude Code	`/sc:[command] --flags`	行为修改	`/sc:analyze --think-hard`

记住：所有 /sc: 命令和 @agent- 调用都在 Claude Code 聊天中工作，而不是在您的终端中。它们触发 Claude Code 从 SuperClaude 框架中读取特定的上下文文件。

基本命令

立即提高生产力的核心工作流命令：

`/sc:brainstorm` - 项目发现

目的：交互式需求发现和项目规划语法：/sc:brainstorm "您的想法" [--strategy systematic|creative]

使用案例：

新项目规划：/sc:brainstorm "e-commerce platform"
特性探索：/sc:brainstorm "user authentication system"
问题解决：`/sc:brainstorm "slow database queries"``

`/sc:implement` - 功能开发

目的: 通过智能专家路由进行全栈功能实现
语法: /sc:implement "feature description" [--type frontend|backend|fullstack] [--focus security|performance]

使用场景:

身份验证: /sc:implement "JWT login system"
UI 组件: /sc:implement "responsive dashboard"
APIs: /sc:implement "REST user endpoints"
数据库: /sc:implement "user schema with relationships"

`/sc:analyze` - 代码评估

目的: 跨质量、安全性和性能的综合代码分析
语法: /sc:analyze [path] [--focus quality|security|performance|architecture]

使用场景:

项目健康: /sc:analyze .
安全审计: /sc:analyze --focus security
性能评审: /sc:analyze --focus performance

`/sc:troubleshoot` - 问题诊断

目的: 系统化问题诊断与根本原因分析
语法: /sc:troubleshoot "问题描述" [--type build|runtime|performance]

使用场景:

运行时错误: /sc:troubleshoot "登录时出现500错误"
构建失败: /sc:troubleshoot --type build
性能问题: /sc:troubleshoot "页面加载缓慢"

`/sc:test` - 质量保证

目的: 全面测试与覆盖率分析
语法: /sc:test [--type unit|integration|e2e] [--coverage] [--fix]

使用场景:

完整测试套件: /sc:test --coverage
单元测试: /sc:test --type unit --watch
端到端验证: /sc:test --type e2e

`/sc:improve` - 代码增强

目的: 应用系统化的代码改进和优化
语法: /sc:improve [path] [--type performance|quality|security] [--preview]

使用场景:

常规改进: /sc:improve src/
性能优化: /sc:improve --type performance
安全加固: /sc:improve --type security

`/sc:document` - 文档生成

目的: 为代码和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` - 实现规划

目的: 从需求生成结构化的实现计划
语法: /sc:workflow "功能描述" [--strategy agile|waterfall] [--format markdown]

使用场景:

功能规划: /sc:workflow "用户身份验证"
冲刺规划: /sc:workflow --strategy agile
架构规划: /sc:workflow "微服务迁移"

常用工作流

经过验证的命令组合：

新项目设置

/sc:brainstorm "项目概念"              # 定义需求
/sc:design "系统架构"                  # 创建技术设计  
/sc:workflow "实现计划"                # 制定开发路线图

功能开发

/sc:implement "功能名称"               # 构建功能
/sc:test --coverage                   # 通过测试验证
/sc:document --type api               # 生成文档

代码质量改进

/sc:analyze --focus quality           # 评估当前状态
/sc:improve --preview                 # 预览改进
/sc:test --coverage                   # 验证变更

Bug调查

/sc:troubleshoot "问题描述"            # 诊断问题
/sc:analyze --focus problem-area      # 深度分析
/sc:improve --fix --safe-mode         # 应用针对性修复

完整命令参考

开发命令

命令	目的	最适用于
workflow	实现规划	项目路线图，冲刺规划
implement	功能开发	全栈功能，API开发
build	项目编译	CI/CD，生产构建
design	系统架构	API规范，数据库模式

分析命令

命令	目的	最适用于
analyze	代码评估	质量审计，安全评审
troubleshoot	问题诊断	Bug调查，性能问题
explain	代码解释	学习，代码评审

质量命令

命令	目的	最适用于
improve	代码增强	性能优化，重构
cleanup	技术债务	清理无用代码，组织整理
test	质量保证	测试自动化，覆盖率分析
document	文档生成	API文档，用户指南

项目管理

命令	目的	最适用于
estimate	项目估算	时间线规划，资源分配
task	任务管理	复杂工作流，任务跟踪
spawn	元编排	大型项目，并行执行

实用工具命令

命令	目的	最适用于
git	版本控制	提交管理，分支策略
index	命令发现	探索功能，查找命令

会话命令

命令	目的	最适用于
load	上下文加载	会话初始化，项目启用
save	会话持久化	检查点，上下文保存
reflect	任务验证	进度评估，完成验证
select-tool	工具优化	性能优化，工具选择

命令索引

按功能分类：

规划: brainstorm, design, workflow, estimate
开发: implement, build, git
分析: analyze, troubleshoot, explain
质量: improve, cleanup, test, document
管理: task, spawn, load, save, reflect
工具: index, select-tool

按复杂度分类：

初学者: brainstorm, implement, analyze, test
中级: workflow, design, improve, document
高级: spawn, task, select-tool, reflect

故障排除

命令问题：

命令未找到: 验证安装: python3 -m SuperClaude --version
无响应: 重启 Claude Code 会话
处理延迟: 使用 --no-mcp 测试不使用 MCP 服务器

快速修复：

重置会话: /sc:load 重新初始化
检查状态: SuperClaude install --list-components
获取帮助: 故障排除指南

下一步

标志指南 - 控制命令行为
智能体指南 - 专家激活
示例手册 - 真实使用模式

11 KiB Raw Blame History Unescape Escape

SuperClaude 命令指南

命令类型

快速测试

🎯 理解 SuperClaude 命令

SuperClaude 如何工作

命令类型：

上下文机制：

安装命令 vs 使用命令

🧪 Testing Your Setup

🖥️ 终端验证（在终端/CMD 中运行）

💬 Claude Code 测试（在 Claude Code 聊天中输入）

📝 Command Quick Reference

目录

基本命令

/sc:brainstorm - 项目发现

/sc:implement - 功能开发

/sc:analyze - 代码评估

/sc:troubleshoot - 问题诊断

/sc:test - 质量保证

/sc:improve - 代码增强

/sc:document - 文档生成

/sc:workflow - 实现规划

常用工作流

新项目设置

功能开发

代码质量改进

Bug调查

完整命令参考

开发命令

分析命令

质量命令

项目管理

实用工具命令

会话命令

命令索引

故障排除

下一步

11 KiB

Raw Blame History

`/sc:brainstorm` - 项目发现

`/sc:implement` - 功能开发

`/sc:analyze` - 代码评估

`/sc:troubleshoot` - 问题诊断

`/sc:test` - 质量保证

`/sc:improve` - 代码增强

`/sc:document` - 文档生成

`/sc:workflow` - 实现规划