Superclaude Spec Workflow

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

框架命令

CLI命令

建筑

┌─────────────────────────────────────────────────────────────────────────────┐
│                      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服务器：

代理

19家代理商按级别组织：

指导文件

指导文件定义了项目背景：

• product.md：愿景、目标、非目标、目标用户、成功指标
• tech.md：堆栈、约定、编码标准
• structure.md：目录布局、关键文件

这些文件指导所有代理，并确保一致的、有项目意识的响应。

规范工作流程

规范工作流是一个具有用户批准门的4阶段流程：

1. 需求阶段 → 用户批准 requirements.md
2. 设计阶段 → 用户批准 design.md
3. 任务阶段 → 用户批准 tasks.md
4. 实施 → 执行验证

每个阶段包括：

• 置信度检查器（≥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

致谢

该项目基于并整合了这些优秀的开源项目的想法：

我们感谢这些作者在人工智能辅助开发工作流程方面的开创性工作。

许可证

麻省理工学院

贡献

欢迎投稿！请在提交PR之前阅读投稿指南。

______________________________________________________________________

*SuperClaude Spec工作流-统一的AI驱动开发框架*