Login
NomenAK/SuperClaudePlease refer to the latest official releases for information GitHub Homepage

AI 驱动的浏览器自动化框架，结合自然语言和代码控制浏览器

MITShell 7.6kNomenAKSuperClaude Last Updated: 2025-07-13

SuperClaude - 专业化AI开发框架

项目概述

SuperClaude是一个综合性的配置框架，专门设计用于增强Claude Code的功能。它将Claude Code从通用AI助手转变为专业化的AI开发伙伴，提供19个专业化命令、9个认知角色和先进的开发方法论。

核心特性

🎯 认知角色系统

SuperClaude提供9个专业化认知角色，每个角色都有特定的专业领域和思维模式：

角色 专业领域 使用场景 示例命令
architect 系统设计、长期可维护性 规划大型系统 /persona:architect → /user:design --api --ddd
frontend 用户体验、视觉界面 UI/UX工作 /persona:frontend → /user:build --react
backend 性能、可靠性、API 服务端开发 /persona:backend → /user:build --api
analyzer 根本原因分析、循证决策 调试复杂问题 /persona:analyzer → /user:troubleshoot --investigate
security 威胁建模、安全优先 安全评审 /persona:security → /user:scan --security
mentor 教学、引导式发现 学习/解释 /persona:mentor → /user:explain --depth
refactorer 代码质量、简化 代码改进 /persona:refactorer → /user:improve --quality
performance 速度优化、瓶颈分析 性能调优 /persona:performance → /user:improve --performance
qa 质量保证、测试 测试工作流 /persona:qa → /user:test --coverage

🛠️ 专业化命令系统

SuperClaude提供18个专业化斜杠命令，涵盖整个开发生命周期：

开发命令（3个）

  • /user:build - 通用项目构建器
    • --init 新项目，--feature 添加功能，--react React应用，--api 后端，--tdd 测试驱动
  • /user:dev-setup - 开发环境设置
    • --install 工具，--ci CI/CD，--monitor 监控
  • /user:test - 测试框架
    • --coverage 覆盖率，--watch 监听模式，--e2e 端到端测试

分析与改进命令（4个）

  • /user:analyze - 多维度分析
    • --code 代码审查，--architecture 设计，--profile 性能，--security 漏洞
  • /user:troubleshoot - 调试与修复
    • --investigate 探索，--fix 修复，--five-whys 根本原因，--prod 生产环境
  • /user:improve - 增强代码/性能
    • --quality 重构，--performance 优化，--iterate 持续改进，--threshold 目标百分比
  • /user:explain - 深度解释
    • --depth 复杂程度，--visual 图表，--examples 代码示例

运维命令（6个）

  • /user:deploy - 应用部署
  • /user:migrate - 数据库/代码迁移
  • /user:scan - 安全与验证
  • /user:estimate - 时间/复杂度预测
  • /user:cleanup - 项目维护
  • /user:git - Git工作流管理

设计与架构命令（1个）

  • /user:design - 系统设计
    • --api REST，--ddd 领域驱动设计，--prd 需求，--openapi 规范，--graphql GraphQL

工作流命令（2个）

  • /user:spawn - 创建专业化子代理
  • /user:document - 文档创建

系统命令（1个）

  • /user:load - 加载项目上下文

🔧 MCP（模型上下文协议）集成

SuperClaude集成了四个强大的MCP服务器：

  1. Context7 (C7) - 自动文档查找

    • 即时查找库文档
    • 与GitHub工作流无缝集成

  2. Sequential - 复杂分析

    • 深层问题的顺序思考
    • 适合系统设计和根本原因分析

  3. Magic - UI生成

    • 自动创建React组件
    • 智能UI构建

  4. Puppeteer - 浏览器测试

    • 验证UI组件
    • 性能监控

🚀 核心优势

Token优化

  • UltraCompressed模式：70%的Token减少
  • 使用电报风格简化：移除冠词/连词/介词
  • 符号化：→(到), &(和), @(在), w/(与), +(添加), -(移除)
  • 缩写：cfg(配置), fn(函数), impl(实现)

研究优先方法

  • 自动查找官方文档
  • 循证决策制定
  • 引用驱动的实现

自适应思维

  • 根据任务调整分析深度
  • 智能工具选择
  • 上下文感知响应

安装与配置

自动安装

git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
./install.sh

手动安装

# 1. 创建结构
mkdir -p ~/.claude/commands/shared

# 2. 复制配置文件
cp CLAUDE.md RULES.md PERSONAS.md MCP.md ~/.claude/

# 3. 复制命令
cp .claude/commands/*.md ~/.claude/commands/

# 4. 复制共享资源
cp .claude/commands/shared/*.yml ~/.claude/commands/shared/

验证安装

# 检查安装
ls -la ~/.claude/ # 应显示4个主要文件
ls -la ~/.claude/commands/ # 应显示17个文件（16个命令 + 索引）

# 测试使用
# 在Claude Code中打开任何项目并尝试：
/user:analyze --code
/persona:architect

项目结构

~/.claude/
├── CLAUDE.md          # 主配置（加载其他文件）
├── RULES.md           # 治理与实践
├── PERSONAS.md        # 9个认知原型
├── MCP.md             # 模型上下文协议模式
└── commands/          # 17个专业化斜杠命令 + 索引
    ├── analyze.md
    ├── build.md
    ├── cleanup.md
    ├── deploy.md
    ├── design.md
    ├── dev-setup.md
    ├── document.md
    ├── estimate.md
    ├── explain.md
    ├── git.md
    ├── improve.md
    ├── index.md
    ├── load.md
    ├── migrate.md
    ├── scan.md
    ├── spawn.md
    ├── test.md
    ├── troubleshoot.md
    └── shared/        # 19个配置资源
        ├── ambiguity-check.yml
        ├── audit.yml
        ├── checkpoint.yml
        ├── cleanup-patterns.yml
        ├── command-memory.yml
        ├── documentation-dirs.yml
        ├── evidence.yml
        ├── git-operations.yml
        ├── git-workflow.yml
        ├── impl.yml
        ├── loading-cfg.yml
        ├── mcp-flags.yml
        ├── patterns.yml
        ├── performance-monitoring.yml
        ├── planning-mode.yml
        ├── research-first.yml
        ├── thinking-modes.yml
        ├── ultracompressed.yml
        └── validation.yml

使用示例

通用标志

所有命令支持的通用标志：

规划与思维

  • --plan - 运行前显示执行计划
  • --think - 标准分析模式（多文件上下文）
  • --think-hard - 深度分析模式（架构级别）
  • --ultrathink - 关键分析模式（系统级）

文档控制

  • --ultracompressed / --uc - ~70% Token减少模式

MCP服务器控制

  • --c7 / --no-c7 - 启用/禁用Context7文档
  • --seq / --no-seq - 启用/禁用Sequential思维
  • --magic / --no-magic - 启用/禁用Magic UI构建器
  • --pup / --no-pup - 启用/禁用Puppeteer浏览器
  • --all-mcp - 启用所有MCP服务器
  • --no-mcp - 禁用所有MCP服务器（仅原生工具）

工作流示例

完整开发流程

/persona:architect → /user:load --depth deep → /user:analyze --architecture
/user:design --api --ddd → /user:estimate --detailed
/persona:backend → /user:build --api
/persona:frontend → /user:build --react → /user:test --coverage
/persona:security → /user:scan --security → /user:improve --quality
/user:cleanup --all → /user:deploy --env staging

调试工作流

/persona:analyzer → /user:troubleshoot --investigate --prod → /user:analyze --profile
"think hard about performance bottlenecks" → /user:troubleshoot --five-whys
/persona:performance → /user:improve --performance --iterate --threshold 90%

测试与质量保证

/persona:qa → /user:test --e2e → /user:scan --validate
/persona:mentor → /user:explain --depth beginner --visual --examples
/user:document --user → /user:build --tdd → /user:analyze --code

文档组织

操作文档 vs 项目文档

SuperClaude自动分离操作报告和项目文档：

.claudedocs/           # Claude操作文档
├── audit/
├── reports/
├── summaries/
├── metrics/
└── incidents/

/docs                  # 项目文档
├── api/
├── guides/
├── architecture/
└── development/

自动报告

  • analyze → reports/
  • scan → reports/
  • test → metrics/
  • troubleshoot → incidents/

手动文档

  • /user:document → API → /docs/api/
  • 指南 → /docs/guides/

高级功能

模型适配

  • 简单任务 → sonnet（成本效益）
  • 复杂任务 → sonnet-4（平衡）
  • 关键任务 → opus-4（最大能力）

便捷命令

  • /compact - 智能减少
  • /clear - 全新开始
  • /model - 切换模型

检查点系统

Git集成的检查点系统允许开发者导航回工作流中的任何点：

/user:git --checkpoint before-refactor
/user:git --rollback

故障排除

常见问题

  1. 命令无法工作：检查 ls ~/.claude/commands/（应显示17个文件）
  2. 规划问题：添加 --plan 标志 → /user:deploy --plan
  3. 角色问题：/persona:architect → /persona:security → /user:scan --security
  4. MCP问题："React docs" → C7 | "slow app" → Sequential

维护命令

  • 更新：cd SuperClaude && git pull && ./install.sh
  • 备份：cp -r ~/.claude/ ~/.claude.backup.$(date +%Y%m%d)
  • 卸载：rm -rf ~/.claude/

项目优势

开发者优势

  • ✅ 所有项目的一致工作流
  • ✅ 研究优先方法 → 总是查找官方文档
  • ✅ 质量标准 → 内置最佳实践
  • ✅ 认知专业化 → 每个任务的正确思维模式

适用场景

  • 开发者 → 更快、更智能的编码工作流
  • 团队 → 一致的AI辅助模式
  • 项目 → 质量专注的开发
  • 学习 → AI引导的技能发展

技术特点

符号系统

SuperClaude使用独特的符号系统来提高效率：

符号 含义 缩写 含义
→ 导致 cfg 配置
& 和/与 fn 函数
w/ 与 impl 实现
@ 在/位于 env 环境
+ 添加/包含 dev 开发
- 移除/排除 auth 认证
∀ 对于所有/每个 API 应用接口

版本信息

  • 当前版本：v4.0.0
  • 类型：配置框架（非可执行代码）
  • 兼容性：Claude Code
  • 安装位置：~/.claude/（全局安装）

总结

SuperClaude将Claude Code从通用AI助手转变为专业化的开发伙伴，提供：

  • 专业化的认知角色系统
  • 全面的命令工具集
  • 智能的MCP集成
  • 高效的Token优化
  • 研究驱动的方法论

这个框架特别适合需要一致、高质量AI辅助开发体验的开发者和团队。通过其模块化设计和专业化方法，SuperClaude确保每个开发任务都能获得适当的专业知识和工具支持。

Star History Chart