项目简介
SPEK增强开发平台是一个全面的企业级多智能体工作流编排系统。它采用Queen-Princess-Drone分层架构,集成了超过85个专业AI智能体,163个斜杠命令,并深度整合了15+ Model Context Protocol (MCP) 服务器,包括桌面自动化能力。平台提供三循环开发系统(规划、开发、质量保障),通过真实性验证和零剧场检测机制,确保高质量、可审计的开发成果。
主要功能点
- 分层智能体编排: 采用Queen-Princess-Drone蜂群层次结构,高效协调90+专业AI智能体执行开发任务。
- 多平台AI集成: 无缝整合OpenAI (GPT-5 Codex)、Gemini Pro/Flash 和 Claude Opus/Sonnet 等多种AI模型,并根据任务自动优化模型选择。
- 桌面自动化: 通过Bytebot集成,使AI智能体能够控制桌面应用程序(如VS Code、Firefox),实现UI测试和复杂工作流自动化。
- MCP服务器集成: 平台自身包含一个桌面自动化MCP服务器,并与记忆、GitHub、文件系统、浏览器自动化等15+ MCP服务器深度集成,提供丰富的上下文信息和工具调用能力。
- Prompt模板管理: 提供163+斜杠命令作为Prompt模板,引导LLM客户端行为,实现完整开发工作流的自动化。
- 三循环开发系统: 独创的迭代开发方法论,涵盖发现与规划、开发与实施、CI/CD质量与调试三个循环,确保项目从规划到验证的全生命周期质量。
- 零剧场与真实性验证: 内置剧场检测和真实性验证机制,确保所有实现都基于实际功能和可验证的证据。
安装步骤
- 克隆仓库:
git clone https://github.com/DNYoussef/Spek-template - 安装Node.js依赖:
npm install - 安装Python分析器(可选,用于高级代码分析):
pip install -e ./analyzer - 验证基本功能:
- 运行代码风格检查 (Linting): 'npm run lint'
- 运行安全扫描 (Security Scan): 'npm run security'
- 运行构建验证 (Build Validation): 'npm run build'
- 初始化SPARC(部分命令需要):
npx claude-flow@latest init --sparc - 修复Python测试依赖(如果pytest失败):
pip install --upgrade pytest
服务器配置
该平台包含一个名为 'bytebot-desktop' 的桌面自动化MCP服务器。MCP客户端可以通过以下JSON-RPC配置信息与此服务器建立连接。
{ "servers": { "bytebot-desktop": { "command": "node", "args": [ "./src/services/desktop-agent/mcp/index.js" ], "env": { "BYTEBOT_DESKTOP_URL": "http://localhost:9990" }, "description": "提供AI驱动的桌面应用程序控制和UI测试工具,如截图、点击、文本输入等。通过与Bytebot后端服务通信实现真实世界桌面自动化。此服务器是SPEK平台的一部分,为LLM客户端提供桌面操作上下文和功能调用。" } } }
- 'server name' ('bytebot-desktop'): 此名称标识桌面自动化MCP服务器。
- 'command' ('node'): 启动服务器所需的执行器。
- 'args' ('["./src/services/desktop-agent/mcp/index.js"]'): 启动服务器所需的脚本路径,指定了MCP服务器的入口文件。
- 'env' ('{"BYTEBOT_DESKTOP_URL": "http://localhost:9990"}'): 服务器运行所需的环境变量,指定Bytebot桌面服务的URL,这是桌面自动化服务所需的一个后端依赖。
基本使用方法
- 定义项目规范 ('SPEC.md'):
使用您喜欢的编辑器创建或打开 'SPEC.md' 文件,详细描述您的项目需求。
vim SPEC.md - 启动三循环开发系统:
- 新项目 (正向流程: 规划 → 开发 → 质量):
./scripts/3-loop-orchestrator.sh forward - 现有代码库 (逆向流程: 分析 → 规划 → 修复 → 验证):
./scripts/3-loop-orchestrator.sh reverse - 逐步修复现有项目:
./scripts/codebase-remediation.sh /path/to/project progressive 10
- 新项目 (正向流程: 规划 → 开发 → 质量):
- 在Claude Code CLI中使用斜杠命令:
在Claude Code CLI中,您可以像聊天一样,通过引用斜杠命令模板来引导AI智能体的行为。例如:
- "Follow /research:web pattern to find best authentication libraries" (遵循网页研究模式查找最佳认证库)
- "Use /dev:swarm workflow to implement the auth system" (使用开发蜂群工作流实现认证系统)
- "Apply /qa:run validation suite to verify quality" (应用QA验证套件验证质量) 这些命令会根据 '.claude/commands/' 目录下的定义来执行相应的开发流程。
信息
分类
开发者工具