项目简介

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质量与调试三个循环,确保项目从规划到验证的全生命周期质量。
  • 零剧场与真实性验证: 内置剧场检测和真实性验证机制,确保所有实现都基于实际功能和可验证的证据。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/DNYoussef/Spek-template
  2. 安装Node.js依赖:
    npm install
  3. 安装Python分析器(可选,用于高级代码分析):
    pip install -e ./analyzer
  4. 验证基本功能:
    • 运行代码风格检查 (Linting): 'npm run lint'
    • 运行安全扫描 (Security Scan): 'npm run security'
    • 运行构建验证 (Build Validation): 'npm run build'
  5. 初始化SPARC(部分命令需要):
    npx claude-flow@latest init --sparc
  6. 修复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,这是桌面自动化服务所需的一个后端依赖。

基本使用方法

  1. 定义项目规范 ('SPEC.md'): 使用您喜欢的编辑器创建或打开 'SPEC.md' 文件,详细描述您的项目需求。
    vim SPEC.md
  2. 启动三循环开发系统:
    • 新项目 (正向流程: 规划 → 开发 → 质量):
      ./scripts/3-loop-orchestrator.sh forward
    • 现有代码库 (逆向流程: 分析 → 规划 → 修复 → 验证):
      ./scripts/3-loop-orchestrator.sh reverse
    • 逐步修复现有项目:
      ./scripts/codebase-remediation.sh /path/to/project progressive 10
  3. 在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/' 目录下的定义来执行相应的开发流程。

信息

分类

开发者工具