前言¶

多人協作的 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 不一致，以倉庫內容爲準。）