前言¶

在 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