使用说明

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-code

Claude代码文档

2.Gemini CLI（可选）

需要大量令牌操作委托（2M令牌上下文）。

# Install via npm
npm install -g @google/gemini-cli

# Authenticate
gemini auth

Gemini CLI文档

快速开始

选项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驱动开发框架