AI AGENT·TEAM WORKFLOW·HARNESS

EP-Harness:从个人 AI Coding 到
团队级 Agent 工作流

个人用 AI 写代码很方便,团队化却会暴露 Prompt 无人审、经验不沉淀、链路没闭环 三大缺口。得物技术团队的 EP-Harness 把 Agent 当团队成员来管理 —— 核心不是让模型更强,而是让它能在真实研发流程里正确工作。

作者方舟 来源微信公众号「得物技术」 整理2026-09-08 · 补嵌原文 16 图 2026-09-15 原文链接 ↗

4团队缺口
3分层 · server · daemon · CLI
4演化层 · Prompt→Loop→Harness→团队
16原文配图 · 全量嵌入
≈ 9 min阅读时长
AGENT · AS · TEAM MEMBER A1 Backend Claude runtime execution A2 Frontend Codex runtime review · skill A3 Ops OpenCode runtime monitor · loop Issue Queue · Server 需求 · 任务 · 评论 · 历史 Workflow · Skills · Runtime · 飞书 EP · HARNESS
目录
  1. §1 本地 AI Coding 的团队级缺口
  2. §2 EP-Harness:团队级 Agent 工作系统
  3. §3 分层可组合架构
  4. §4 Backend.Execute 统一契约
  5. §5 AI Coding 的四层演化
  6. §6 Agent 需要理解真实研发现场
  7. §7 Prompt 从技巧变成团队规程
  8. §8 从复制粘贴到结构化上下文
  9. §9 Harness:可执行可观察可治理
  10. §10 Loop:把重复工作变成可控闭环
  11. §11 落地效果
  12. §12 后续演进
  13. §13 结语

§1团队化痛点

本地 AI Coding 的四个团队级缺口

直接在本地用 AI Coding 工具,短期看很方便。团队化之后,几个缺口会同时暴露。

  • Prompt 没有 Review — 代码有 Code Review,prompt 没有。Agent 指令写得好不好、有没有歧义、有没有安全风险、能不能复用,往往只靠个人判断。
  • 经验无法沉淀 — 日志排查步骤、部署检查方式、开发提示词通常只留在个人本地文件里,下一个人还要重新摸索。
  • 过程缺少可见性 — 谁在用哪个 Agent?用了什么模型和 runtime?成功率、耗时、token 花费是多少?没有平台化就很难进入团队管理。
  • 研发链路没有闭环 — Agent 写完代码不是结束。代码审查、推送、部署、提测、CR 反馈、BUG 回流和日志巡检如果仍靠人手动接力,价值就停在局部提效。
EP-Harness 的核心价值,就是把这些缺口从个人习惯问题变成平台能力。

§2产品定位

EP-Harness:团队级 Agent 工作系统

EP-Harness 可以理解为一个 Managed Agents 平台。它把 Agent 当成团队里的工作成员来管理:Agent 有身份、有任务、有状态、有执行记录、有可见性、有权限边界,也有自己的 instructions、skills、runtime 和历史产出。

技术基座:EP-Harness 是基于开源项目 Multica 的二次开发。Multica 官方定位是 open-source managed agents platform,核心思路是把 coding agents 作为可分配任务、可跟踪进度、可沉淀技能的真实队友来管理;EP-Harness 在这个基座上,进一步贴合公司研发流程和内部系统。

在 EP-Harness 里,任务不是散落在聊天窗口里,而是进入 Issue。Issue 可以关联项目、需求、应用分支、工作流、评论、执行日志、文件变更和后续反馈。

  • 当 Agent 的任务进入 Issue,团队就可以追踪它。
  • 当 Agent 的规则进入 Instructions 和 Workflow,团队就可以审查它。
  • 当 Agent 的经验进入 Skills,团队就可以复用它。
  • 当 Agent 的执行进入 Runtime 和日志,团队就可以复盘它。
  • 当 Agent 的结果进入部署、评审和反馈链路,团队就可以让它持续闭环。

§3架构

分层可组合架构:server · daemon · CLI

从架构上看,Multica 由三部分协作:

EP-Harness 分层可组合架构:Agent 集成层、工作流编排层、能力组合层与治理反馈闭环
原文图 2 · 分层可组合架构:统一任务抽象接入 Claude Code / Cursor / Codex / OpenCode 等多种 CLI,Issue/RDC 驱动 Propose→Develop→Review→Archive 交付轨道,按场景装配运行时 × 模型 × Skill × MCP,治理反馈闭环沉淀回 Agent 配置与工作流
Developer Machine · 本机 TUI · IDE · Web · 飞书通知 daemon 领取任务 · 调用本地 CLI AI Coding CLI Claude · Codex · OpenCode · ACP workspace · 工作目录 · 代码执行现场 Server · 团队侧 管理工作区 · Issue · 成员 · 任务队列 · 实时更新 Issue 任务 · 评论 · 历史 Workflow 阶段目标 · 交付要求 Skills 沉淀方法 · 工具说明 Runtime · Logs 执行记录 · 失败信息 用户/客户端连接 daemon 拉取任务并回报结果
图 1 · server · daemon · AI CLI:三层协作,任务从 server 落到本机

三个角色各司其职:

  • Server 管理工作区、Issue、成员和任务队列,承担实时更新 —— 团队记忆。
  • Daemon 运行在开发者本机,领取任务并调用本地 AI 编程 CLI —— 本机代理。
  • AI 编程 CLI 在本地工具链和工作目录中完成实际代码执行 —— 执行现场。
Multica 基座与 EP-Harness 延展的三行对照表
原文图 3 · Multica 基座 × EP-Harness 延展:基础对象(Workspace/Agent/Issue/任务队列/Runtime → 关联需求、项目、应用分支、工作流)、执行链路(daemon 本机领取任务 → 结果接入部署评审反馈闭环)、平台边界(server 管数据不执行任务 → 保留本地执行与权限边界,适配内部研发体系)

§4执行契约

Backend.Execute:统一的 Agent 执行契约

EP-Harness 在 server/pkg/agent/agent.go 中以 Backend.Execute(ctx, prompt, ExecOptions) 作为各 Agent Runtime 的统一入口。agent.New 根据 agentType 和 Config 选择具体 Provider Backend。

// 各 Runtime 对上层暴露一致的生命周期
type Backend interface {
    Execute(ctx context.Context,
            prompt string,
            opts ExecOptions) (<-chan Event, error)
}

// Claude / Codex / OpenCode / ACP 各自保留协议与参数
func New(agentType string, cfg Config) (Backend, error) { ... }
server/pkg/agent/agent.go 中 Backend 接口定义与 claudeBackend.Execute 实现的 IDE 截图
原文图 4 · IDE 实拍:server/pkg/agent 里的 Backend 接口与 claudeBackend.Execute 实现,右侧可见 antigravity / codebuddy / codex / copilot / cursor / devoco / dfsh / gemini / grok / kimi / hermes 等各 Provider Backend 文件 —— 一个契约,十余种实现

Claude、Codex、OpenCode、ACP 等实现可以保留各自的参数、进程和传输协议,但对上层暴露一致的执行生命周期 —— 上层不必关心底层工具到底跑哪一家。

Backend.Execute 统一执行契约 · 一致生命周期 Claude Anthropic SDK Codex App Server 协议 OpenCode 事件流 · TUI ACP Agent 协议 各 Provider 保留自有参数、进程、传输协议 → 上层不感知差异 换 Runtime = 改一行配置,业务逻辑零变更
图 2 · Backend.Execute:四个 Runtime,一个契约

这一层抽象的直接收益是Runtime 可插拔。Claude 升级到新版、Codex 切换新协议、OpenCode 加入新能力,业务侧只需要改一行配置,Issue、Workflow、Skills 这些上层抽象完全不动。

§5演化模型

AI Coding 正在经历四层外扩

AI Coding 的使用方式正在经历四层变化。它们不是互相替代,而是逐层外扩:从"怎么问",走向"喂什么材料",再走向"如何执行和约束",最终走向"如何持续闭环"。

L1 · Prompt 怎么问 · 个人技巧 个人 AI Coding 工具已覆盖 L2 · Context 喂什么材料 · 文档 · 代码 · 历史 个人 AI Coding 工具已覆盖 L3 · Harness 如何执行与约束 · 权限 · 沙箱 · Runtime EP-Harness 覆盖 L4 · Team Loop 如何持续闭环 · Issue · Workflow · Skills · 治理 EP-Harness 覆盖
图 3 · AI Coding 四层:个人工具解决前两层,EP-Harness 解决后两层
Prompt/Context/Harness/Loop Engineering 四阶段关注点与典型问题表
原文图 5 · 四层的关注点与典型问题:Prompt Engineering(怎么问)→ Context Engineering(喂什么材料)→ Harness Engineering(怎么执行和约束)→ Loop Engineering(怎么持续闭环)

个人 AI Coding 工具通常解决前两层。EP-Harness 还解决后两层,并把四层能力放进团队研发流程。

EP-Harness 从需求到可复用工程资产的六阶段流程:Propose、Develop、Review、Test、Release、Archive
原文图 6 · 从需求到可复用工程资产:OpenSpec artifacts 驱动六阶段协作(Propose 提案/设计 → Develop 实现/验证 → Review 对抗式审查 → Test 测试与验收 → Release 发布 → Archive 沉淀资产),上钻交付物流演进,下钻 Agent 写权限边界 —— 每阶段只写自己该写的,禁止越权或无证据推进

§6内部系统

Agent 需要理解真实研发现场

通用 AI Coding 工具并不了解公司的研发体系。它不知道需求结构,不知道内部飞书文档权限,不知道应用分支如何创建,不知道代码管理和发布平台的实际流程,也不知道每个团队沉淀过哪些 Skills。

EP-Harness 的价值,就是把这些内部系统接进 Agent 的工作环境里。它要解决的不是"模型有没有能力写代码",而是"模型能不能在我们的研发流程里正确工作"。

六大内部系统与 Agent 工作流连接的价值表
原文图 7 · 内部系统连接价值:需求管理(需求进工作流、BUG 回流)、飞书(通知/文档读取/评论同步)、代码管理(分支/提交/MR/评审)、发布平台(部署状态/失败回流)、Skills Hub(经验复用)、日志/流水线(错误发现、自动创建后续任务)

外部工具能给你一个 Agent,EP-Harness 要给团队一个 Agent 可以工作的组织环境。

§7规程化

Prompt 从个人技巧变成团队规程

很多团队刚开始用 AI 时,会把重点放在 prompt 技巧上。但用得久了会发现,更重要的是把 prompt 变成可维护的规程。

五类规程化入口与作用表
原文图 8 · 五类规程化入口:Agent Instructions(身份与行为边界)、Instruction Templates(角色与任务模式模板化)、Workflow Stage Guides(提议/开发/评审/归档分阶段要求)、Runbook(自动化任务稳定执行步骤)、Skills(可复用经验与输出规范)

§8上下文工程

从复制粘贴到结构化上下文

Agent 做不好,很多时候不是模型不够强,而是上下文不对。需求背景、设计文档、验收标准、关联代码仓库、目标分支、历史讨论、失败记录和内部系统调用方式,不应该靠用户每次手动复制粘贴。

EP-Harness 把这些材料变成 Issue / 需求 / 项目 / Workflow / Skills / Runtime / 飞书集成 / 运行记录 八个固定组件,由平台自动装配:

组件承载的内容
Issue任务目标、评论、状态和历史记录
需求业务背景、需求文档和迭代信息
项目业务边界和仓库资源
Workflow阶段目标和交付要求
Skills团队沉淀的方法和工具说明
Runtime真实执行环境
飞书集成通知、讨论和文档读取能力
运行记录执行过程、产出和失败信息

这样 Agent 不再只拿到一段文字描述,而是进入一个由 Issue、项目、文档、分支、评论和运行记录组成的工作现场。

Context Engineering 的重点不是把上下文塞满,而是让正确上下文在正确时机进入 Agent。

§9运行时

Harness:让 Agent 可执行、可观察、可治理

一个裸模型没有工作目录,不会天然知道当前项目怎么测试,也不会自动遵守团队规范,更不会自己接入需求管理、代码管理、发布平台、飞书和日志平台。Harness 的价值,就是在模型外面补齐这些工程能力。

Agent decide next next-token 可执行 executable 可观察 observable 可治理 governable 可沉淀 reusable 可审查 reviewable 可恢复 recoverable
图 4 · Harness 的六个能力:围绕 Agent Loop 的运行时边界
Harness 七项能力在 EP-Harness 中的体现表
原文图 9 · Harness 能力落地:Runtime 管理(Claude Code/Codex/OpenCode/Kimi/Cursor 统一管理)、Daemon 执行(真实机器与工作目录)、Worktree/分支(隔离不互染)、执行日志(事件/工具调用/命令输出)、变更查看(审查改了哪些文件)、权限和可见性、用量统计(token/费用/耗时/失败率)

这让 Agent 从"一个能说话的模型"变成"一个可管理的执行单元"。对团队来说,更重要的不是 Agent 某次回答得多漂亮,而是它能否长期稳定地在工程约束里工作。

§10闭环

Loop:把重复工作变成可控闭环

Loop Engineering 不是让 Agent 一直跑,也不是无限自动化。有价值的 Loop,需要包含发现、派发、执行、验证、记录和下一步决策 —— EP-Harness 中两类典型 Loop 已经稳定运行:

Loop A · 上游版本更新分析 定时检查外部 release 判断是否已有分析 Issue 发现新版本 → 创建分析 Issue Agent 分析影响 / 风险 / 迁移建议 需落地 → 拆成迁移子任务 Loop B · 线上日志巡检 按时间窗口拉取异常 聚合错误 fingerprint · 影响范围 · 样本 Agent 分析可能根因 生成修复建议 / 验证建议 必要时创建后续修复 Issue
图 5 · 两条 Loop:外部 release 跟踪 + 线上日志巡检,各有判断与产出

这些场景的关键不是"Agent 自动跑了",而是每一轮都有记录、判断、产出和后续动作。Loop 的价值在闭环,不在循环本身。

§11落地效果

决策追溯 · 多 Agent 协作 · 自动化治理

EP-Harness 实践价值闭环总览:以 Issue 为中心串联决策追溯、多 Agent 协作、自动化治理与效率提升
原文图 10 · 实践价值闭环总览:以 Issue 为中心 —— 决策追溯(PRD/分支/验证记录可回放)、多 Agent 协作(Propose→Develop→Review→Archive,Review 可打回 Develop)、自动化治理(日志巡检→fingerprint 聚类→修复验证,2400+ 条/4h 收敛到个位数)、效率提升(提交推送/多环境部署/失败处理),每次交付都回流 Issue 形成下一轮决策输入

决策追溯

需求交付完成后,可依托 Issue 中沉淀的决策记录、实现说明,快速还原当时的实现背景和关键取舍。

关键决策的追溯对象、开发过程与沉淀价值表
原文图 11 · 决策追溯:Issue 中保留 PRD、需求分支、测试分支、发布分支和实现说明 —— 避免只看到代码 diff,看不到当时的取舍
新人入职看一周 Issue,就能接手一个模块 —— 不再依赖老员工的口头传承。

多 Agent 协作

案例结论:通过将交付流程拆分为提议、开发、评审、归档等阶段,并引入多 Agent 协作机制,形成从需求澄清、实现落地、质量评审到经验沉淀的闭环,持续提升代码质量。

提议、开发、评审、归档四阶段的 Agent 动作与沉淀价值表
原文图 12 · 多 Agent 协作:提议(Propose 读取需求/Issue/代码规约,产出 OpenSpec 变更方案,先固化范围与验收点)、开发(Develop 按 OpenSpec 落地,过程可回放)、评审(Review 结构化检查架构/正确性/安全/测试,可明确打回 Develop)、归档(Archive 归档变更文档与最终规格,沉淀为可复用经验资产)

自动化治理

治理成效:累计自动化修复 100+ 个异常日志问题,异常日志从高频暴露逐步收敛,问题识别、归类和修复效率明显提升。典型高频问题由治理前每 4 小时 2400+ 条,降低到治理后的个位数。

自动巡检、问题归类、修复闭环、效果收敛四个治理环节的关键数据与运营价值表
原文图 13 · 自动化治理:自动巡检(线上日志巡检覆盖 EP-Harness)、问题归类(按 route/fingerprint/count 聚类,累计命中 100+ 已完成问题)、修复闭环(Issue 内沉淀错误分类/样本日志/修复记录/验证命令)、效果收敛(每 4 小时 2400+ 条降到个位数)

§12演进路线

后续演进

EP-Harness 下一阶段能力扩展:工作流演进、本地执行融合、上下文智能三条并行主线
原文图 14 · 下一阶段能力扩展(并行·无先后):工作流演进(任务模板/执行约束/验收闭环)、本地执行融合(Web 任务编排 × DewuCode Agent,打通平台与桌面端)、上下文智能(CodeGraph 代码图谱、codebase-memory-mcp 代码库记忆、rtk token 优化),结果汇聚为可复用工作流、桌面协同、定位更快、长任务更稳
流程连接、执行治理、经验沉淀、效果度量四个演进方向表
原文图 15 · 四个演进方向:流程连接(让 Agent 执行天然落在团队现有流程)、执行治理(可观察、可审查、可接管)、经验沉淀(instructions/workflow/Skills/上下文模板沉淀为团队资产)、效果度量(成功率、人工接管点、返工原因、耗时分布等指标让平台演进有数据依据)

§13结语

从个人工具,到团队生产力

AI Coding 的第一阶段,是个人把 Agent 当工具。下一阶段,是团队把 Agent 当协作成员。当 Agent 开始接触真实需求、真实代码、真实部署和真实反馈时,单纯依赖聊天窗口和本地 prompt 已经不够。

团队需要一个平台,把 Agent 的任务、上下文、规则、执行、审查、反馈和度量都组织起来。当这套机制跑起来,Agent 才能从一个个人电脑里的助手,慢慢变成团队研发流程里可管理、可复用、可持续优化的生产力。

个人 AI Coding 解决"我今天能不能写得更快";
EP-Harness 这类平台要回答的是"团队明天还能不能一起写得更快"。

← 学习站索引