codeagent

```

┌─────────────────────────────────────────────────────────────────┐

│ 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://peterfile.github.io/devpilot-agents/)

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

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

```bash

cd flowchart

npm install

npm run dev

```

核心入口：[orchestration_loop.py](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 中描述任务即可自动触发技能：

| 触发示例 | 技能 |

| ----------------------------------------------------------- | ---------