前言¶

多人协作的 agent 小队里最常见的问题不是模型能力不足，而是规则不一致：DRI、reviewer、lead、运维各写各的 instructions，同一套交接格式抄了四遍，改了一处忘了另三处。agent-loop-workflow 就是一个项目无关的多 agent 协作工作流骨架，把角色职责、交接格式、评审分流和交付顺序收敛到一个 skill 里，每个 agent 加载同一个骨架即可。

参与方是 DSH（DeepSeek Harness）生态中的插件，维护者是 LeslieWylie，许可证 MIT。

这是什么¶

一句话定位：一个项目无关的多 agent 协作工作流骨架，供由 DRI + reviewer + lead + 运维组成的 agent 小队加载。

它解决的问题是：避免在每个 agent 的 instructions 里各抄一份同样的规则。骨架只定义协作流程本身，与具体项目、issue 追踪器、代码托管平台解耦。

核心功能¶

下面介绍 README 中列出的八个模块，按「角色—约束—交接—评审—收口」的顺序拆开看。

角色拓扑：定义 DRI（执行者）、reviewer（评审）、lead（决策/路由）、运维（自动化）四类角色及其职责边界。

Loop Guard 六不变量：轮次上限、无进展检测、同错熔断、耗时预警、显式退出门、单一权威写入。这是抑制 agent 空转或反复重试的那一层。

标准 handoff 格式：六字段交接模板——负责人 / 目标 / 输入 / 写操作 / 验收标准 / 失败证据。

风险三档分流：fast / standard / high 三档，按改动范围自动路由到不同的 reviewer。

交付顺序：验证 → commit → push → Draft MR/PR → 就绪信号 → in_review，固定流程。

review→收口协议：in_review 后自动派发、reviewer 结论以 metadata 形式给出、支持打回重试与升级机制。

防回环：幂等建单、状态变更不触发重复派发、人工来源甄别。

通用红线：密钥保密、token 权限分离、破坏性操作确认。

安装与启用¶

安装命令取自 README 原文。注意仓库归属是 LeslieWylie/agent-loop-workflow：

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

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

load agent-loop-workflow

两步的作用分别是：插件安装把 skill 文件注册进当前 DSH profile；load 命令在会话内启用它，之后各 agent 即可引用骨架里的规则。

典型用法¶

经过上面的步骤，一个典型回合可以这样走：

1、DRI 完成任务后，用六字段 handoff 格式把自己的产出交接给下一环节。
2、lead 按改动范围判断风险档位（fast / standard / high），路由到对应 reviewer。
3、reviewer 在 in_review 阶段给出结论 metadata；不通过则打回重试，或按升级机制向上处理。
4、运维负责自动化动作，Turn Guard 六不变量持续监控轮次、进展与耗时。

整个过程不依赖外部服务，只调用 DSH 的 skill 加载机制。README 同时说明，插件不绑定平台：把「issue」「MR」映射到你自己那套即可。

适用场景与注意¶

适合想为 agent 小队统一协作规范、但不想在每个 agent 的 instructions 里反复复制规则的场景。README 给出的设计原则有三条：

• 项目无关：只定义流程骨架。具体项目的代码坑、评审清单、仓库路径应放在各项目自己的 *-conventions / *-engineering / *-review-rules skill 里。
• 零依赖：不需要任何外部服务，只依赖 DSH 的 skill 加载机制。
• 不绑定平台：不指定 issue 追踪器或代码托管平台。

需要注意两点。第一，插件以当前 DSH 进程权限运行，安装前应先检查源码与许可证（本项目为 MIT）。第二，package.json 显示版本为 0.1.1，Node 引擎要求 >=18，devDependencies 里有 @deepseek-ai/cordis 与 @deepseek-ai/dsh-skill，说明它走的是 DSH cordis 的 patch bundle 机制，改动前建议先跑自带的测试脚本：

npm test
node scripts/check-pack.mjs

结尾¶

agent-loop-workflow 的价值在于把多 agent 协作中重复的、易错的流程规则收敛成一个可共享的骨架，而不是四处复制的 instructions。如果你的团队正在搭建 DRI + reviewer + lead + 运维的小队，可以先从这套角色拓扑和六字段交接格式入手。

目录页：https://www.skillhub.cn/plugins/YaoleWu/agent-loop-workflow
GitHub：https://github.com/LeslieWylie/agent-loop-workflow

（注：目录页路径中的 YaoleWu 与 README 及 GitHub 仓库实际归属 LeslieWylie 不一致，以仓库内容为准。）