mithun50 3762d6ab24 feat: restore complete SuperClaude framework from commit d4a17fc
Comprehensive restoration of all agents, modes, MCP integrations, and documentation.

## 🤖 Agents Restored (20 total)
Added 17 new agent definitions to existing 3:
- backend-architect, business-panel-experts, deep-research-agent
- devops-architect, frontend-architect, learning-guide
- performance-engineer, pm-agent, python-expert
- quality-engineer, refactoring-expert, requirements-analyst
- root-cause-analyst, security-engineer, socratic-mentor
- system-architect, technical-writer

## 🎨 Behavioral Modes (7)
- MODE_Brainstorming - Multi-perspective ideation
- MODE_Business_Panel - Executive strategic analysis
- MODE_DeepResearch - Autonomous research
- MODE_Introspection - Meta-cognitive analysis
- MODE_Orchestration - Tool coordination
- MODE_Task_Management - Systematic organization
- MODE_Token_Efficiency - Context optimization

## 🔌 MCP Server Integration (8)
Documentation and configs for:
- Tavily (web search)
- Serena (session persistence)
- Sequential (token-efficient reasoning)
- Context7 (documentation lookup)
- Playwright (browser automation)
- Magic (UI components)
- Morphllm (model transformation)
- Chrome DevTools (performance)

## 📚 Core Documentation (6)
- PRINCIPLES.md, RULES.md, FLAGS.md
- RESEARCH_CONFIG.md
- BUSINESS_PANEL_EXAMPLES.md, BUSINESS_SYMBOLS.md

## 📖 Documentation Restored (152 files)
- User-Guide (en, jp, kr, zh) - 24 files
- Developer-Guide - 5 files
- Development docs - 10 files
- Reference docs - 10 files
- Getting-Started - 2 files
- Plus examples and templates

## 📦 Package Configuration
Updated pyproject.toml and MANIFEST.in to include:
- modes/**/*.md
- mcp/**/*.md, **/*.json
- core/**/*.md
- examples/**/*.md
- Comprehensive docs in distribution

## 📁 Directory Structure
plugins/superclaude/ and src/superclaude/:
- agents/ (20 files)
- modes/ (7 files)
- mcp/ (8 docs + 8 configs)
- core/ (6 files)
- examples/ (workflow examples)

docs/:
- 152 markdown files
- Multi-language support (en, jp, kr, zh)
- Comprehensive guides and references

## 📊 Statistics
- Commands: 30
- Agents: 20
- Modes: 7
- MCP Servers: 8
- Documentation Files: 152
- Total Resource Files: 200+

Created docs/reference/comprehensive-features.md with complete inventory.

Source: commit d4a17fc
Total changes: 150+ files added/modified

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-13 16:16:05 +01:00

10 KiB
Raw Blame History

SuperClaude 标志指南 🏁

大多数标志会自动激活 - Claude Code 读取行为指令,根据您请求中的关键词和模式来调用适当的上下文。

基本自动激活标志90% 的使用案例)

核心分析标志

标志 何时激活 作用
--think 5+ 个文件或复杂分析 标准结构化分析(约 4K 令牌)
--think-hard 架构分析、系统依赖关系 深度分析(约 10K 令牌)配合增强工具
--ultrathink 关键系统重设计、遗留系统现代化 最大深度分析(约 32K 令牌)配合所有工具

MCP 服务器标志

标志 服务器 目的 自动触发
--c7 / --context7 Context7 官方文档、框架模式 库导入、框架问题
--seq / --sequential Sequential 多步推理、调试 复杂调试、系统设计
--magic Magic UI 组件生成 /ui 命令、前端关键词
--play / --playwright Playwright 浏览器测试、E2E 验证 测试请求、视觉验证
--morph / --morphllm Morphllm 批量转换、模式编辑 批量操作、样式强制执行
--serena Serena 项目内存、符号操作 符号操作、大型代码库

行为模式标志

标志 何时激活 作用
--brainstorm 模糊请求、探索关键词 协作发现思维模式
--introspect 自我分析、错误恢复 透明地展现推理过程
--task-manage >3 步骤、复杂范围 通过委托进行协调
--orchestrate 多工具操作、性能需求 优化工具选择和并行执行
--token-efficient / --uc 上下文 >75%、效率需求 符号增强通信,减少 30-50% 令牌使用

执行控制标志

标志 何时激活 作用
--loop "improve"、"polish"、"refine" 关键词 迭代增强循环
--safe-mode 生产环境,>85% 资源使用 最大验证,保守执行
--validate 风险 >0.7,生产环境 执行前风险评估
--delegate >7 个目录或 >50 个文件 子智能体并行处理

特定命令标志

分析命令标志 (/sc:analyze)

标志 目的
--focus 针对特定领域 security, performance, quality, architecture
--depth 分析彻底程度 quick, deep
--format 输出格式 text, json, report

构建命令标志 (/sc:build)

标志 目的
--type 构建配置 dev, prod, test
--clean 构建前清理 布尔值
--optimize 启用优化 布尔值
--verbose 详细输出 布尔值

设计命令标志 (/sc:design)

标志 目的
--type 设计目标 architecture, api, component, database
--format 输出格式 diagram, spec, code

解释命令标志 (/sc:explain)

标志 目的
--level 复杂度级别 basic, intermediate, advanced
--format 解释风格 text, examples, interactive
--context 领域上下文 任何领域(如 reactsecurity

改进命令标志 (/sc:improve)

标志 目的
--type 改进焦点 quality, performance, maintainability, style, security
--safe 保守方法 布尔值
--interactive 用户指导 布尔值
--preview 显示但不执行 布尔值

任务命令标志 (/sc:task)

标志 目的
--strategy 任务方法 systematic, agile, enterprise
--parallel 并行执行 布尔值
--delegate 子智能体协调 布尔值

工作流命令标志 (/sc:workflow)

标志 目的
--strategy 工作流方法 systematic, agile, enterprise
--depth 分析深度 shallow, normal, deep
--parallel 并行协调 布尔值

故障排除命令标志 (/sc:troubleshoot)

标志 目的
--type 问题类别 bug, build, performance, deployment
--trace 包含跟踪分析 布尔值
--fix 执行修复 布尔值

清理命令标志 (/sc:cleanup)

标志 目的
--type 清理目标 code, imports, files, all
--safe / --aggressive 清理强度 布尔值
--interactive 用户指导 布尔值
--preview 显示但不执行 布尔值

估算命令标志 (/sc:estimate)

标志 目的
--type 估算焦点 time, effort, complexity
--unit 时间单位 hours, days, weeks
--breakdown 详细分解 布尔值

索引命令标志 (/sc:index)

标志 目的
--type 索引目标 docs, api, structure, readme
--format 输出格式 md, json, yaml

反思命令标志 (/sc:reflect)

标志 目的
--type 反思范围 task, session, completion
--analyze 包含分析 布尔值
--validate 验证完整性 布尔值

生成命令标志 (/sc:spawn)

标志 目的
--strategy 协调方法 sequential, parallel, adaptive
--depth 分析深度 normal, deep

Git 命令标志 (/sc:git)

标志 目的
--smart-commit 生成提交消息 布尔值
--interactive 引导操作 布尔值

工具选择命令标志 (/sc:select-tool)

标志 目的
--analyze 工具分析 布尔值
--explain 解释选择 布尔值

测试命令标志 (/sc:test)

标志 目的
--coverage 包含覆盖率 布尔值
--type 测试类型 unit, integration, e2e
--watch 监视模式 布尔值

高级控制标志

范围和焦点

标志 目的
--scope 分析边界 file, module, project, system
--focus 领域定向 performance, security, quality, architecture, accessibility, testing

执行控制

标志 目的
--concurrency [n] 控制并行操作 1-15
--iterations [n] 改进循环 1-10
--all-mcp 启用所有 MCP 服务器 布尔值
--no-mcp 仅使用本地工具 布尔值

系统标志SuperClaude 安装)

标志 目的
--verbose / -v 详细日志 布尔值
--quiet / -q 静默输出 布尔值
--dry-run 模拟操作 布尔值
--force 跳过检查 布尔值
--yes / -y 自动确认 布尔值
--install-dir 目标目录 路径
--legacy 使用传统脚本 布尔值
--version 显示版本 布尔值
--help 显示帮助 布尔值

常用使用模式

前端开发

/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

后端开发

/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

大型项目

/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

质量和维护

/sc:improve src/ --type quality --safe --interactive
/sc:cleanup imports --type imports --preview
/sc:reflect --type completion --validate
/sc:git commit --smart-commit

标志交互

兼容组合

  • --think + --c7:带文档的分析
  • --magic + --playUI 生成带测试
  • --serena + --morph:项目内存带转换
  • --safe-mode + --validate:最大安全性
  • --loop + --validate:带验证的迭代改进

冲突标志

  • --all-mcp vs 单独的 MCP 标志(使用其中之一)
  • --no-mcp vs 任何 MCP 标志(--no-mcp 获胜)
  • --safe vs --aggressive(清理强度)
  • --quiet vs --verbose(输出级别)

自动启用关系

  • --safe-mode 自动启用 --uc--validate
  • --ultrathink 自动启用所有 MCP 服务器
  • --think-hard 自动启用 --seq + --c7
  • --magic 触发以 UI 为中心的智能体

标志故障排除

常见问题

  • 工具过多:使用 --no-mcp 仅用本地工具测试
  • 操作太慢:添加 --uc 压缩输出
  • 验证阻塞:在开发中使用 --validate 而不是 --safe-mode
  • 上下文压力:在 >75% 使用率时自动激活 --token-efficient

调试标志

/sc:analyze . --verbose                      # 显示决策逻辑和标志激活
/sc:select-tool "操作" --explain        # 解释工具选择过程
/sc:reflect --type session --analyze         # 审查当前会话决策

快速修复

/sc:analyze . --help                         # 显示命令的可用标志
/sc:analyze . --no-mcp                       # 仅本地执行
/sc:cleanup . --preview                      # 显示将被清理的内容

标志优先级规则

  1. 安全第一--safe-mode > --validate > 优化标志
  2. 显式覆盖:用户标志 > 自动检测
  3. 深度层次--ultrathink > --think-hard > --think
  4. MCP 控制--no-mcp 覆盖所有单独的 MCP 标志
  5. 范围优先级system > project > module > file

相关资源