工单进来，代码就能开始流转？OpenProject Agent Engine 的自动派工与人工门控
把 AI 编码 Agent 接进团队，不难做出一个“根据提示改代码”的演示；难的是把它放进真实交付流程：谁领取工单、在哪个仓库工作、何时进入评审、失败后如何暂停，都需要明确且可追溯。OpenProject Agent Engine 尝试把这些流程规则放在项目管理系统一侧，让 Agent 专注执行代码任务，而不是自行决定工单状态。
让 OpenProject 保持流程主控
该项目由 310 Networks 发布，采用 MIT 许可证。README 将 OpenProject 定为工单的事实来源：引擎轮询符合条件的 work package，认领任务并更新状态，为 Agent 准备独立 clone、渲染提示，再启动 pi coding agent；完成后由引擎核验 GitHub 与 OpenProject 的结果，并执行状态迁移。Agent 本身不直接改工单状态。
这一区分很重要。自动化系统可以尝试实现任务，但“完成”不等于“通过”：实现 Agent 创建 PR 后，工单进入 Ready for Review；审查 Agent 完成且 PR 合并后，才关闭工单。没有 PR 或验证失败时，流程可以转入 On Hold 等待人工处理。对于被拒绝的任务，引擎也支持重新进入实现阶段。
| 环节 | 引擎职责 | 结果示例 |
|---|---|---|
| 实现 | 认领任务、切换到 In Progress、启动实现 Agent | 创建 PR，或转入 On Hold |
| 评审 | 对已有 PR 启动 reviewer | 合并后关闭，拒绝则标记 Rejected |
| 暂停 | 将异常或不完整任务置于 On Hold | 人工移动工单后再恢复处理 |
因此它不是“让 Agent 自由操作项目管理系统”的薄封装，而是把状态机、认领和结果核验集中在引擎里。文档还说明，每张工单使用独立分支，分支名形如 op-；On Hold 是终态，需由人移动工单才能重新进入处理。
部署前要准备什么
项目要求 Docker、OpenProject 17（API v3）、一个项目以及一次性管理员配置；每个受监控项目还要关联 GitHub 仓库，并提供可执行 clone、push 和 PR 操作的 token。首次部署需要在 OpenProject 配置状态、GIT_REPO 项目属性、AGENT 工单自定义字段和 Agent Worker 角色，然后在 docker/ 目录运行交互式初始化脚本。
git clone https://github.com/310networks/openproject-agent-engine op-agent-engine cd op-agent-engine/docker ./agent-init.sh
初始化后，补齐 docker/.env 中的 GitHub 凭据和模型提供商密钥，再启动服务：
docker compose up -d docker compose logs -f engine
README 列出了 OP_BASE_URL、OP_PROJECT、OP_ENGINE_TOKEN、AGENT_MODEL、各 Agent 的 OpenProject token、GH_TOKEN 等配置。项目可按 AGENT_MODEL= 指定模型，也可为 frontend、backend、designer、reviewer 单独设置模型。若使用本地 llama.cpp 路由器，还需配置 LLAMA_BASE_URL，并确保容器内部可访问该地址。
这里有两点容易被忽略。第一，GIT_REPO 是项目属性而非每张工单的自由文本；第二，若分支保护要求 PR 作者以外的账号审批，需配置专用 reviewer GitHub 账号及对应 token，否则同一账号无法满足该规则。仓库 README 还提醒：项目或其仓库/Agent 配置变更后需重启 engine；修改 .env 则应让 Compose 重建 engine 容器。
适合谁先试
它适合已经使用 OpenProject 管理任务、且希望在受控边界内试验自动实现与自动评审的工程团队。开始时建议只接入一个测试项目、准备隔离仓库和低权限 token，并先用项目文档中的验收清单验证状态流转、分支保护与失败恢复；不要直接把生产项目和高权限凭据交给未经验证的 Agent 流程。
当前实现有明确边界：README 描述的是固定角色团队与 pi coding agent 工作流，并非任意 Agent 编排平台；部署依赖 Docker、OpenProject 与 GitHub；状态迁移由引擎负责，人工仍需处理 On Hold 任务。把这些限制写进试点方案，比把“自动化”理解为无人值守更可靠。
小结
OpenProject Agent Engine 的价值不只在于启动编码 Agent，而在于把“领取—实现—评审—合并—状态更新”组织成可检查的工单流程。它提供了一个值得关注的设计思路：让 Agent 负责产出，让外围控制器负责权限、状态与验证。对团队而言，最稳妥的落地顺序仍是先验证权限和异常分支，再逐步扩大可自动处理的任务范围。
相关链接