---
slug: "devpilot-agents"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/peterfile/devpilot-agents@master/README.md"
repo: "https://github.com/peterfile/devpilot-agents"
source_file: "README.md"
branch: "master"
---
中文 | [English](https://github.com/peterfile/devpilot-agents/blob/HEAD/README_EN.md)

# DevPilot Agents: 多代理编排框架

> **"亚瑟王的王者之剑已破石而出……你是否愿随王一同奔赴疆场？"**

专为复杂软件工程任务设计的高保真 **多代理编排系统**。借鉴"圆桌会议"哲学，由 **亚瑟王** (编排者) 协调专业代理，大规模地实现、评审并同步代码库变更。

**设计哲学**：通过 **Spec-Driven Development** 将需求拆解为原子任务，每个 Agent 只处理其上下文范围内的工作——无需理解全局，专注执行即可。任务分发给 **Codex CLI** (OpenAI) 和 **Gemini CLI** (Google) 等一线 Coding CLI，借力厂商的模型能力，而非重复造轮子去构建冗余的工具链和 sub-agent。

## 核心亮点

```
┌─────────────────────────────────────────────────────────────────┐
│  kiro-specs                          multi-agent-orchestrator  │
│  ───────────                         ────────────────────────  │
│  需求 → 设计 → 任务                   圆桌会议并行执行 tasks.md  │
│         ↓                                     ↓                 │
│  .kiro/specs/feature/tasks.md  ──────→  AGENT_STATE.json       │
└─────────────────────────────────────────────────────────────────┘
```

| 阶段            | 说明                                                                |
| --------------- | ------------------------------------------------------------------- |
| **1. 规范定义** | `kiro-specs` 引导创建 requirements → design → tasks                 |
| **2. 圆桌执行** | `multi-agent-orchestrator` 读取 tasks.md，分发给 Codex/Gemini (TDD) |
| **3. 评审闭环** | 每个任务经历 dispatch → review → fix → consolidate                  |

## 核心架构：圆桌会议

| 角色                     | 代理     | 职责                                    |
| :----------------------- | :------- | :-------------------------------------- |
| **亚瑟王 (King Arthur)** | 编排者   | 规划、授权、质量门禁及项目状态同步。    |
| **高文 (Gawain)**        | 决策骑士 | 内环决策、严格的 JSON 输出及逻辑验证。  |
| **Codex/Gemini**         | 执行者   | 分布式执行代码 (Codex) 与 UI (Gemini)。 |
| **codeagent-wrapper**    | 执行层   | 驱动后端并行运行的 Go 运行时。          |

## 前置要求

| 依赖项                   | 版本   | 用途                     |
| ------------------------ | ------ | ------------------------ |
| **Node.js**              | 18+    | 运行 `npx skills add`    |
| **Python**               | 3.9+   | 编排脚本                 |
| **Go**                   | 1.21+  | 编译 `codeagent-wrapper` |
| **Claude Code/OpenCode** | 最新版 | 触发技能                 |

## 安装步骤

### 步骤 1：安装技能

```bash
npx skills add PeterFile/devpilot-agents
```

此命令将本仓库的所有技能安装到你的代理环境中。

### 步骤 2：编译 codeagent-wrapper

```bash
git clone https://github.com/PeterFile/devpilot-agents.git
cd devpilot-agents/codeagent-wrapper
go build -o codeagent-wrapper .
```

Windows：

```powershell
go build -o codeagent-wrapper.exe .
```

### 步骤 3：添加到 PATH

**Linux/macOS：**

```bash
export PATH="$PWD:$PATH"
```

**Windows (PowerShell)：**

```powershell
$env:PATH = "$PWD;$env:PATH"
```

### 步骤 4：配置 OpenCode 代理（仅 OpenCode）

将代理定义复制到你的项目：

```bash
cp -r .opencode/agents/ <你的项目>/.opencode/agents/
```

或全局安装（对所有项目生效）：

```bash
cp -r .opencode/agents/ ~/.config/opencode/agents/
```

这将添加 **亚瑟王** (编排者) 和 **高文** (决策骑士) 到你的 OpenCode 环境。

## 流程图

[![多代理编排流程图](https://github.com/peterfile/devpilot-agents/raw/HEAD/flowchart.png)](https://peterfile.github.io/devpilot-agents/)

**[查看交互式流程图](https://peterfile.github.io/devpilot-agents/)** - 点击逐步查看动画演示。

`flowchart/` 目录包含源代码。本地运行：

```bash
cd flowchart
npm install
npm run dev
```

## 自动循环机制

核心入口：[`orchestration_loop.py`](https://github.com/peterfile/devpilot-agents/blob/HEAD/skills/multi-agent-orchestration/scripts/orchestration_loop.py)

通过 `codeagent-wrapper` 调用 LLM 后端（默认 `opencode`），每轮迭代：

1. 读取 `AGENT_STATE.json` + `PROJECT_PULSE.md`
2. LLM 返回 JSON 决策 → 执行 `dispatch_batch` / `dispatch_reviews` 等动作
3. 检查完成状态 → 循环或退出

### 环境变量

| 变量                       | 作用                             | 默认值           |
| -------------------------- | -------------------------------- | ---------------- |
| `CODEAGENT_OPENCODE_AGENT` | 指定 OpenCode 使用的代理（可选） | OpenCode 默认    |
| `CODEAGENT_OPENCODE_MODEL` | 覆盖 OpenCode 模型（可选）       | OpenCode 配置    |
| `CODEAGENT_NO_TMUX`        | 禁用 tmux                        | Windows 自动设置 |

### 退出码

- `0`：完成 | `1`：停止/无进展 | `2`：需人工决策

## 使用技能

在 Claude Code / OpenCode 中描述任务即可自动触发技能：

| 触发示例                                                    | 技能                     |
| ----------------------------------------------------------- | ------------------------ |
| "Start orchestration from spec at `.kiro/specs/my-feature`" | multi-agent-orchestrator |
| "Run orchestration for `payment-integration`"               | multi-agent-orchestrator |
| "Create requirements for a new feature"                     | kiro-specs               |
| "Help me write tests first"                                 | test-driven-development  |

### 可用技能

| 技能                         | 描述                                      |
| ---------------------------- | ----------------------------------------- |
| **multi-agent-orchestrator** | 从 Kiro 规范编排多代理工作流              |
| **kiro-specs**               | 规范驱动工作流：需求 → 设计 → 任务 → 执行 |
| **test-driven-development**  | 红-绿-重构 TDD 工作流                     |

## 项目结构

```
├── skills/
│   ├── multi-agent-orchestration/   # 核心编排技能
│   ├── kiro-specs/                  # 规格驱动工作流技能
│   └── test-driven-development/     # TDD 技能
├── .opencode/agents/                # 代理定义
├── codeagent-wrapper/               # Go 执行引擎
└── docs/                            # 文档
```

## 文档

- **[架构说明 (docs/ARCHITECTURE_CN.md)](https://github.com/peterfile/devpilot-agents/blob/HEAD/docs/ARCHITECTURE_CN.md)**：圆桌会议代理协作机制。
- **[快速开始 (docs/QUICK-START_CN.md)](https://github.com/peterfile/devpilot-agents/blob/HEAD/docs/QUICK-START_CN.md)**：入门指南。

## 致谢

本项目基于以下优秀开源项目构建：

| 组件                  | 来源                                                  |
| --------------------- | ----------------------------------------------------- |
| **codeagent-wrapper** | [cexll/myclaude](https://github.com/cexll/myclaude)   |
| **编排循环思路**      | [ralph](https://github.com/snarktank/ralph)           |
| **Skills 规范**       | [claude_skills](https://github.com/anthropics/skills) |

---

**Claude Code + 分布式编排 = 自主工程的未来。**