前言¶

在 DeepSeek Harness（DSH）里搭多 agent 协作时，常见的做法是把工作流规则写在每个 agent 的 instructions 里：执行者一份、评审一份、lead 一份。规则一多就难以保持一致，改一处要同步多处。更麻烦的是循环失控——agent 反复重试同一个错误、无人判定何时停止、handoff 信息在角色之间传递时丢失。

下面介绍的 agent-loop-workflow 插件，就是针对这类问题的工作流骨架：把协作协议抽出来，任何 agent 小队加载一次即可，不必在各处各抄一份。

这是什么¶

agent-loop-workflow 是一个项目无关的多 agent 协作工作流骨架，由 LeslieWylie 维护，MIT 许可证，当前版本 0.1.1。它为 DSH 提供循环防护、六字段 handoff、风险分级评审路由与固定交付顺序的协作协议。

它只定义流程骨架本身，零依赖——不需要任何外部服务，只依赖 DSH 的 skill 加载机制。运行环境要求 Node >= 18。

核心功能¶

角色拓扑¶

定义四类角色及职责边界：DRI（执行者）、reviewer（评审）、lead（决策/路由）、运维（自动化）。小队成员各司其职，边界由协议明确。

Loop Guard 六不变量¶

这是循环防护的核心，共六条：轮次上限、无进展检测、同错熔断、耗时预警、显式退出门、单一权威写入。前四条用于发现并打断失控循环，显式退出门保证循环有明确的终止路径，单一权威写入避免多方同时改同一份状态。

六字段 handoff¶

角色之间交接使用固定模板，包含六个字段：负责人、目标、输入、写操作、验收标准、失败证据。每次交接的信息结构一致，接手方不会漏看关键项。

风险三档分流¶

评审按改动范围分为 fast / standard / high 三档，自动路由到不同 reviewer。小改动走快通道，大改动走严格评审。

固定交付顺序¶

交付流程固定为：验证→commit→push→Draft MR/PR→就绪信号→in_review。每一步都有明确的前置条件，不跳步。

review→收口协议与防回环¶

进入 in_review 后自动派发评审，reviewer 结论以 metadata 记录，支持打回重试和升级机制。防回环方面做了三件事：幂等建单、状态变更不触发重复派发、人工来源甄别。

通用红线¶

协议内置三条通用约束：密钥保密、token 权限分离、破坏性操作确认。

安装与启用¶

先安装插件。官方安装命令如下，--profile web 表示安装到 web 这个 profile：

dsh plugin --profile web add "github:LeslieWylie/agent-loop-workflow"

重启后，在任意会话中加载 skill：

load agent-loop-workflow

经过上面的步骤，小队内的 agent 就拿到了统一的工作流规则。

设计原则¶

三条原则值得单独说明：

1、项目无关：只定义协作流程骨架。具体项目的代码坑、评审清单、仓库路径，应放在各项目自己的 *-conventions / *-engineering / *-review-rules skill 里，不要混进这套协议。

2、零依赖：不需要外部服务，安装即用。

3、不绑定平台：skill 不指定任何 issue 追踪器或代码托管平台。协议里的「issue」「MR」是抽象描述，使用时自行映射到你自己的平台即可。

适用场景与注意¶

适合的场景：在 DSH 上组建由 DRI、reviewer、lead、运维构成的多 agent 小队，希望有一套现成的、可复用的协作协议，而不是每次从零写 instructions。

使用前注意两点：

1、插件以当前 dsh 进程的权限运行，安装前建议先检查源码与许可证，确认符合自己的安全要求。仓库地址见文末。

2、它不解决项目级问题。某个仓库怎么评审、哪些目录有坑，应放在项目自己的 conventions / review-rules skill 里，与本插件分层配合。

结尾¶

agent-loop-workflow 解决的是多 agent 协作中的重复劳动和失控风险：一份协议定义角色、交接、评审路由和交付顺序，配合 Loop Guard 兜底循环失控。对小队规模还在演进、协作规则频繁调整的 DSH 开发者来说，是一个可以拿来就改的起点。

• 社区目录页：https://www.skillhub.cn/plugins/LeslieWylie/agent-loop-workflow
• GitHub 仓库：https://github.com/LeslieWylie/agent-loop-workflow