SuperClaude规范工作流程（SCW）
结合Claude Code、SuperClaude代理和Gemini委托的统一AI驱动开发框架。
什么是SCW？
SuperClaude Spec Workflow是一个全面的框架，通过以下方式增强了Claude Code：
- 19个AI代理：根据任务类型激活上下文感知角色
- 7种行为模式：头脑风暴、研究、代币效率等
- 9台MCP服务器：扩展能力（顺序思维、serena、context7、tavily等）
- 双子座代表团：2M令牌容量，用于令牌密集型操作
- 规范驱动的工作流：经用户批准的阶段性功能开发
需求
在使用SCW之前，您需要：
1.克劳德代码（必填）
Anthropic用于AI驱动开发的官方CLI工具。
# Install via npm
npm install -g @anthropic-ai/claude-code2.Gemini CLI（可选）
需要大量令牌操作委托（2M令牌上下文）。
# Install via npm
npm install -g @google/gemini-cli
# Authenticate
gemini auth快速开始
选项A：从npm安装（推荐）
# Install CLI globally
npm install -g @neverg3t/scw-cli
# Setup MCP servers
scw mcp setup
# Initialize your project
cd your-project
scw init选项B：从源代码安装
# Clone and build
git clone https://github.com/NeverGET/superclaude-spec-workflow.git
cd superclaude-spec-workflow
npm install
npm run build --workspaces
# Setup MCP servers
./cli/scw/dist/index.js mcp setup
# Initialize your project
cd your-project
/path/to/superclaude-spec-workflow/cli/scw/dist/index.js init开始使用SCW
在您的项目中打开Claude Code并尝试：
/scw:help # See all commands
/scw:brainstorm [topic] # Discover requirements
/scw:spec-create [feature] # Create feature specification所得
目录结构
运行后 scw init，您的项目将具有：
project/
├── .claude/
│ ├── commands/scw/ → SCW commands (symlink)
│ ├── steering/ # Project context
│ │ ├── product.md # Vision, goals, users
│ │ ├── tech.md # Stack, conventions
│ │ └── structure.md # Directory layout
│ ├── specs/ # Feature specifications
│ ├── bugs/ # Bug workflows
│ └── templates/ → Document templates (symlink)
├── agents/ → 19 AI agents (symlink)
├── modes/ → 7 behavioral modes (symlink)
├── CLAUDE.md # Claude's role definition
└── GEMINI.md # Gemini's role definition框架命令
| 命令 | 描述 |
|---|---|
/scw:help | 显示所有可用命令 |
/scw:spec-create [feature] | 创建功能规范（4阶段工作流） |
/scw:spec-execute [task-id] | 执行规范任务 |
/scw:brainstorm [topic] | 苏格拉底式需求发现 |
/scw:design [feature] | 建筑设计工作流程 |
/scw:implement [task] | 使用模式匹配实现 |
/scw:test [scope] | 使用覆盖率报告运行测试 |
/scw:research [topic] | 与双子座代表团深入研究 |
/scw:bug-create [issue] | Bug工作流程（报告→ 分析→ fix → 验证） |
CLI命令
| 命令 | 描述 |
|---|---|
scw init | 在当前项目中初始化SCW |
scw init --quick | 使用默认值快速初始化 |
scw doctor | 检查安装状况 |
scw mcp setup | 配置MCP服务器 |
scw mcp check | 验证服务器是否正在运行 |
scw mcp list | 列出已配置的服务器 |
scw mcp tokens | 管理API令牌 |
建筑
┌─────────────────────────────────────────────────────────────────────────────┐
│ SUPERCLAUDE SPEC WORKFLOW (/scw:*) │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ USER LAYER (Primary Commands) │
│ ├── /scw:spec-create → Requirements → Design → Tasks → Implementation │
│ ├── /scw:spec-execute → Task execution with validation │
│ ├── /scw:bug-create → Report → Analysis → Fix → Verification │
│ └── Steering documents (product.md, tech.md, structure.md) │
│ │
│ ORCHESTRATION LAYER (Claude Code - 200K tokens) │
│ ├── PM Agent: ConfidenceChecker (pre) + SelfCheckProtocol (post) │
│ ├── 19 Merged Agents (auto-activated by context) │
│ ├── 7 Behavioral Modes │
│ ├── 9 MCP Servers (Context7, Tavily, Serena, Sequential, Gemini...) │
│ └── Wave→Checkpoint→Wave parallel execution (3.5x speedup) │
│ │
│ DELEGATION LAYER (Gemini MCP Wrapper - 2M tokens) │
│ ├── 8 MCP Tools: research, file_scan, generate, dialogue, test, etc. │
│ ├── Claude validates ALL Gemini outputs before accepting │
│ ├── Session tracking for multi-step operations │
│ └── Triggers: >10 files, >5 file generation, deep research, bulk tests │
│ │
└─────────────────────────────────────────────────────────────────────────────┘MCP服务器
SCW集成了9台MCP服务器：
| 服务器 | 用途 | 存储库 | 令牌 |
|---|---|---|---|
| 顺序思维 | 复杂问题分解 | 模型上下文协议/服务器 | 没有 |
| serena | 会话持久性 | 奥拉奥斯/塞雷娜 | 没有 |
| context7 | 库文档 | uprish/context7 | 是的(CONTEXT7_API_KEY) |
| tavily | 网络研究 | tavily ai/tavily mcp | 是的(TAVILY_API_KEY) |
| 剧作家 | 浏览器自动化 | 微软/剧作家mcp | 没有 |
| chrome开发工具 | 性能分析 | ChromeDevTools/chrome开发工具mcp | 没有 |
| gemini包装器 | gemini委托 | 包含在SCW中 | 否（gemini CLI身份验证） |
| 文件系统变形 | 快速文件编辑 | morphllm.com/mcp | 是的(MORPH_API_KEY) |
| morph | 语义代码合并 | docs.morphllm.com | 是的(MORPH_API_KEY) |
代理
19家代理商按级别组织：
| 层级 | 代理 | 激活 |
|---|---|---|
| 核心 | pm代理，自我审查 | 始终处于活动状态 |
| 规范工作流程 | 需求分析师、系统架构师、质量工程师 | 基于阶段 |
| 领域 | 后端架构师、前端架构师、安全工程师、devops架构师、性能工程师、python专家 | 基于任务 |
| 分析 | 根本原因分析师、重构专家 | 上下文触发 |
| 研究 | 深度研究代理、苏格拉底式导师、学习指导 | 模式触发 |
| 沟通 | 技术撰稿人、业务专家、回购指数 | 明确请求 |
指导文件
指导文件定义了项目背景：
- product.md：愿景、目标、非目标、目标用户、成功指标
- tech.md：堆栈、约定、编码标准
- structure.md：目录布局、关键文件
这些文件指导所有代理，并确保一致的、有项目意识的响应。
规范工作流程
规范工作流是一个具有用户批准门的4阶段流程：
- 需求阶段 → 用户批准
requirements.md - 设计阶段 → 用户批准
design.md - 任务阶段 → 用户批准
tasks.md - 实施 → 执行验证
每个阶段包括：
- 置信度检查器（≥90%继续）
- 自检协议（完成后验证）
- 反射模式（错误处理和学习）
Gemini集成
克劳德委托双子座进行象征性的重型操作：
- 文件扫描：>10个文件
- 代码生成：>5个文件
- 深入研究：广泛的网络爬行
- 批量测试：大型测试套件
- 上下文溢出：>20万代币的80%
Gemini也可以单独使用：
gemini -p "@src/ Analyze the architecture of this codebase"发展
构建MCP包装器
cd mcp/gemini-wrapper
npm install
npm run build
npm test运行测试
# MCP wrapper tests
cd mcp/gemini-wrapper
npm run validate
# Command validation
node scripts/validate-commands.js创建测试环境
./scripts/setup-test-env.sh
cd ~/test-scw/test-fullstack-app致谢
该项目基于并整合了这些优秀的开源项目的想法：
| 项目 | 作者 | 贡献 |
|---|---|---|
| Claude代码规范工作流程 | Pimzino | 规范驱动的开发工作流程，分阶段审批系统 |
| SuperClaude框架 | SuperClaude Org | 代理架构、行为模式、PM验证模式 |
| SuperGemini框架 | SuperClaude Org | Gemini CLI集成模式、委托策略 |
我们感谢这些作者在人工智能辅助开发工作流程方面的开创性工作。
许可证
麻省理工学院
贡献
欢迎投稿！请在提交PR之前阅读投稿指南。
______________________________________________________________________
*SuperClaude Spec工作流-统一的AI驱动开发框架*