前言¶
用 DSH 這類 AI 編碼工具幹活，最常見的做法是把需求直接丟給一個 AI，讓它從頭寫到尾。上手快，但毛病也明顯：過程不可見，寫得對不對全靠事後人工檢查；一步出問題想回退，只能翻對話記錄；換個會話，進度就斷了。
OpenSpec（Fission-AI/OpenSpec，openspec.sh）解決的是前半段：先寫規範、再寫代碼，把需求整理成 proposal / design / tasks / specs。但規範寫完之後呢？實現、驗證、審查、合併，這些環節還是要使用者自己盯着 AI 一步步做。openspec-agents 補的就是這一段：它把 OpenSpec 變更的實施與質量把關編排成固定流程，交給一組分工明確的智能體執行。
這是什麼¶
openspec-agents 是一個工作流類插件，作者是 ifrankwang，許可證爲 MIT，npm 包名 @ifrankwang/openspec-agents，當前版本 0.133.1。它基於 OpenSpec 構建，專注補全 OpenSpec 變更的實施與質量把關環節。
一句話定位：讓多個 AI 智能體按規範流程協作，把 OpenSpec 變更規範落地爲經過審查的高質量代碼。
插件支持多個 AI 編碼工具原生接入：Claude Code、Codex、ZCode、DeepSeek Harness（DSH）、OpenCode。下面以 DSH 爲例介紹。
核心能力¶
規範驅動與智能體分工¶
插件直接消費項目中的 OpenSpec 變更規範：proposal（變更說明）、design（設計）、tasks（任務清單）、specs（驗收規格），流程與規範一一對應。
執行時不是單個 AI 從頭寫到尾，而是主智能體負責調度，專職智能體分工協作——實現者寫代碼，審查者做檢查，質量把關者做多維驗證。
質量門禁與任務驗證¶
實現完成後要依次過三道檢查：工具檢查、任務驗證、多維度質量審查。發現問題會自動回退到實現環節修復；符合規則的也可以豁免，豁免會留痕。
任務驗證是一道強制門禁：審查結論以 passed 提交時，必須逐項確認全部已申報任務，verified_tasks 全覆蓋。如果因此阻塞，審查者可以補交確認結果解除。
simple 模式下驗證按性質分流：確定性檢查由開發者執行並申報，審查者分級複驗，把精力集中在對抗性判斷上。
隔離執行與過程留痕¶
每個變更在獨立環境中實施，互不干擾；完成後合併並清理環境。
全過程可審計、可恢復：進度、結論、豁免與恢復點全程記錄，中斷後可以接着上次的進度繼續。人工執行或環境無法驗證的任務，通過 blocker 上報，用戶確認留痕（blocker_updates）後憑記錄申報完成。恢復參數 reset_steps 會按流程模式（full / simple）校驗各自的值域後生效。
獨立審查會話¶
除了綁定 OpenSpec 變更的編排流程，插件還支持不綁定任何變更的獨立代碼審查：對 PR 改動區間（review_scope=pr）或全量代碼庫（review_scope=full）做一次完整審查。review_scope 與 change_id / task_group_id 二選一，互斥。
初始化時可以配置顆粒度與修復策略：
1、顆粒度：thorough（分三層，第二層是迴歸驗證）或 simple（單個審查者完成全部檢查）；
2、修復策略：fix（發現問題自動修復後重審）或 none（只審不修）。
thorough 的迴歸驗證要求構建必須通過、既有測試不得出現新失敗；能啓動服務時，還會做冒煙與既有 API 測試。
審查在獨立 worktree 中進行。fix 模式全部通過後，把工作分支合併回目標分支並清理環境；none 模式不合並，直接銷燬工作環境。
安裝與啓用¶
環境準備兩樣東西：Node.js ≥ 23.6（或 Bun）與 git。
DSH 的理念是「一切皆插件」，接入 openspec-agents 只需要一條命令：
dsh plugin --profile web add @ifrankwang/openspec-agents
安裝完成後重啓 dsh web 即可。
典型用法¶
一句話接入¶
安裝之後（甚至還沒安裝時也可以），直接把這句提示詞發給 DSH：
請幫我安裝並啓用 openspec-agents 插件，然後基於當前項目的 OpenSpec 變更規範，執行完整的變更實施編排流程。
英文版：
Please install and enable the openspec-agents plugin for my current AI coding tool, then run the OpenSpec change orchestration workflow on this repository.
如果插件已經裝好，說一句「請運行 openspec-agents 編排流程」即可開工。安裝、初始化、任務分派與質量把關都由 AI 完成。
發起獨立審查¶
獨立審查在初始化時說明三件事：
1、審查範圍：review_scope 傳 pr（兩個本地分支之間的改動區間）或 full（全量代碼庫），與 change_id / task_group_id 互斥；
2、顆粒度：thorough 或 simple；
3、修復策略：fix 或 none。
工具會按審查範圍推導出會話 ID，並在返回結果中告知，後續步驟都使用這個會話 ID 進行。
適用場景與注意¶
先說代價：這套編排流程比單個 AI 直接修改更慢，API 消耗也更高。換來的是穩定、可復現、可審計的實施過程——每一步有門禁，出了問題能回退，中斷了能恢復。
因此它適合對代碼質量、過程可控性要求高的團隊與項目。如果只是改幾行代碼的小活，直接讓 AI 改完可能更省事。
安全上提醒一句：插件以當前 dsh 進程的權限運行，安裝前建議先檢查源碼與許可證。openspec-agents 的源碼在 GitHub 上公開，許可證爲 MIT，確認無誤後再裝。
結尾¶
簡單回顧：OpenSpec 負責把需求變成規範，openspec-agents 負責把規範變成經過門禁審查、全程留痕的代碼，中間不再需要人肉盯流程。如果你的團隊已經在用 OpenSpec 管理變更，值得把它加進工具鏈。
