Orchestrator 使用说明

项目简介

Orchestrator 是一个基于Model Context Protocol（MCP）标准的服务端应用，专注于通过结构化的多阶段**循环（Loops）**来管理人工智能驱动的软件开发和业务工作流。它不仅托管和管理技能（Skills）、循环（Loops）和交付物，还支持会话管理、质量门控和自我学习，帮助开发团队确保工作流程有序且高质量。

主要功能点

标准化的 MCP 协议支持：通过JSON-RPC协议，实现工具（Tools）调用、资源（Resources）管理和Prompt模板渲染，保证与LLM客户端的高效通信。
丰富的工作流Loop体系：支持多种预定义的循环（如工程开发、缺陷修复、提案撰写、审计等），每个循环包含多个阶段，阶段间通过门控保证质量。
技能（Skills）和循环（Loops）动态管理：技能是系统的最小执行单元，循环由阶段和技能组成，支持自定义扩展和版本管理。
交付物管理和保证系统：自动管理执行过程中的各种交付物，配合保证机制确保执行质量和交付物完整性。
多协议通信与REST API：支持MCP标准接口以及丰富的REST API，方便查看执行状态、日志、技能和循环信息。
自我学习和改进：内置学习子系统，根据执行情况和用户反馈，持续优化技能表现和流程。
辅助功能：包括记忆服务、知识图谱、模式检测、多智能体协调、游戏化设计、空闲思考引擎（Dream Engine）、持续执行器等多项协调与增强服务。
Dashboard：提供基于Web的监控UI，展示技能、循环、执行历史和质量门控状态。

安装步骤

环境准备
- 安装 Node.js 版本18及以上
- 安装 Git

安装 Claude Code 客户端

npm install -g @anthropic-ai/claude-code

配置 Orchestrator 命令 从仓库拉取Orchestrator的启动命令配置：

curl -sL https://raw.githubusercontent.com/miles-knowbl/orchestrator/main/commands/orchestrator-start-loop.md \
  > ~/.claude/commands/orchestrator-start-loop.md

启动 Orchestrator 服务 在 Claude Code 中执行命令：
```
/orchestrator-start-loop
```
命令将会克隆仓库、构建项目并自动启动本地HTTP服务器（默认端口3002）。终端窗口将会打开并保持运行状态。

可选：启动Dashboard监控界面

cd apps/dashboard
npm install
npm run dev

浏览器访问 http://localhost:3003 查看运行状态和执行详情。

服务器配置建议

MCP客户端需要配置与Orchestrator的连接信息，示例如下（JSON格式示意，用户可根据客户端UI填写）：

{
  "name": "orchestrator",
  "command": "node",
  "args": [
    "./src/index.js"
  ],
  "env": {
    "PORT": "3002"
  },
  "mcp": {
    "type": "http",
    "url": "http://localhost:3002/mcp"
  }
}

'command' 与 'args'：启动服务的命令行与参数（通常为Node.js执行入口文件）。
'env'：环境变量配置，包含服务监听端口。
'mcp'：MCP服务配置信息，指定使用HTTP协议及对应的地址和端点。

基本使用方法

运行循环（Loop） 在 Claude Code 中，输入循环命令，如 '/engineering-loop'，Orchestrator将开始对应的多阶段流程，逐步引导生成代码、测试、评审等任务。
查看执行状态 可通过REST API或Dashboard中的界面查看执行的当前阶段、技能完成情况和门控审批状态。
操作执行技能和门控 通过MCP工具调用，标记技能完成、批准或拒绝门控等，推动循环顺利进行。
反馈与学习 用户可以对技能执行提供反馈，系统会生成改进建议，支持技能自我进化，提高整体流程效率和质量。
扩展定制 用户可自定义新循环、技能和命令，实现领域专属工作流的创建和管理，满足复杂业务需求。

Orchestrator