前言¶
在 DeepSeek Harness(DSH)裏使用智能體完成工程任務時,常見問題不是單個步驟能不能做,而是任務狀態能不能一直跟得上:當前階段是什麼、用了哪些 Skill、做過哪些決策、Spec 是否批准、Ticket 依賴關係如何、哪些 Lane 已經跑完、review 發現了什麼、最後是否經過人工驗收。如果這些狀態只存在於一次會話裏,任務一旦中斷或切換入口,後續恢復就會變麻煩。
下面介紹的 dsh-matt-skills-flow 是一個非官方 DSH 插件。它把 mattpocock/skills 轉成持久工程工作流,把 Flow、Skill 快照、Decisions、Spec、Ticket Graph、Lane、review findings、人工驗收、證據導出和重啓恢復放在同一個工作流裏。
這是什麼¶
dsh-matt-skills-flow 是一個非官方 DeepSeek Harness 插件,倉庫位於 hollis-openlab/dsh-matt-skills-flow。它的定位是把 mattpocock/skills 轉成可追蹤、可恢復的工程工作流。
它解決的核心問題是:在 DSH Web 環境中使用 Matt Skills 時,如何保留一個任務的關鍵狀態,而不是讓規劃、決策、Spec、Ticket、Lane 執行、review 和驗收分散在零散會話裏。
該插件加載用戶已安裝的 Matt Skills,並不替代 Matt Skills 本身。Matt Skills 仍屬於上游項目所有。插件許可證爲 MIT。
核心功能¶
插件主要提供以下能力:
- 創建 Flow 時快照已安裝的 Matt Skills 及其內容摘要。
- 在 Flow 中保留初始目標或 Bug 上下文,並以交互式生命週期圖可視化 review admission 和簡潔配置摘要。
- 在生成並批准 Spec 前記錄並取代 Decisions。
- 發佈依賴感知的 Ticket Graph,並預覽其可執行 Frontier。
- 默認將 Ticket Graph 發佈爲倉庫本地 Markdown;當 Host 配置選擇
trackerKind: github且存在已認證的ghCLI 時,發佈到 GitHub Issues。 - 從 Flow 擁有的集成分支創建隔離的 Lane 分支和 worktrees。
- 運行有界的 Lane Agents,將阻塞的 Questions 路由回根會話,並用新的 packet digest 重試。
- 順序集成完成的 Lanes,運行雙軸 Standards/Spec review,並要求人工驗收。
- 導出脫敏證據,並在 Harness 重啓後恢復中斷的工作。
- 提供簡體中文和英文本地化的 Web UI。
安裝與啓用¶
運行前提¶
插件面向 DSH Web profile 設計。根據材料,它需要以下環境:
@deepseek-ai/dsh-commands@deepseek-ai/dsh-skill- Git
- 標準 Agent/Subagent 服務
材料還給出 Node 引擎聲明:
>=22.19.0 || >=24
插件的 dsh.client.platform 聲明爲 web,並列出以下 inject 包:
@deepseek-ai/dsh-api-remotes
@deepseek-ai/dsh-client-locale
@deepseek-ai/dsh-client-runtime
@deepseek-ai/dsh-client-ui-slots
安裝¶
材料中給出的安裝方式是安裝一個本地 packed release:
pnpm dsh plugin --profile web add --workspace-root ./deepseek-ai-dsh-matt-skills-flow-0.2.0.tgz
這裏的 ./deepseek-ai-dsh-matt-skills-flow-0.2.0.tgz 是本地路徑。執行前需要確保當前目錄下存在對應包,並且該包來源可信。材料只給出了這種本地 tgz 安裝命令,沒有確認其他官方安裝方式。
啓用¶
安裝後,在側邊欄打開 Matt Skills,然後創建或選擇一個 Flow。
一個 Flow 會綁定到一個已存在的 DSH Workspace 和一個乾淨的 Git 倉庫。啓用時建議先確認當前倉庫狀態乾淨,因爲後續 Lane 會從 Flow 擁有的集成分支創建分支和 worktrees。
典型用法¶
從 Web UI 驅動 Flow¶
在側邊欄打開 Matt Skills 後,可以創建或選擇 Flow。之後按照可見 Gates 推進:
- 記錄 Decisions。
- 批准 Spec。
- 添加併發布 Tickets。
- 準備並運行 Lanes。
- 集成結果。
- review frozen candidate。
- 作爲人類驗收。
這套流程的目標是把任務推進到可驗收狀態,而不是隻完成一次代碼生成。
在會話中使用 /matt-flow 命令¶
活動會話中可以使用以下命令:
/matt-flow start "Add account recovery"
/matt-flow list
/matt-flow status "Add account recovery"
/matt-flow continue <flow-id>
/matt-flow questions <flow-id>
/matt-flow export <flow-id>
/matt-flow continue 最多執行一個無歧義階段轉換。對於 ambiguous 的 planning、review 和 acceptance 決策,它們仍保留爲顯式 UI 動作。
發佈 Ticket Graph¶
Ticket Graph 發佈默認使用倉庫本地 Markdown。
如果需要在 Host 配置中發佈到 GitHub Issues,材料給出如下配置項:
trackerKind: github
githubRepository: owner/name
啓用 GitHub Issues 發佈需要滿足兩個條件:
- Host 配置選擇
trackerKind: github。 - 存在已認證的
ghCLI。
發佈時會驗證 gh 認證,並按依賴順序創建 Issues。插件不會執行其他 GitHub mutations。
適用場景與注意¶
這個插件適合以下情況:
- 在 DSH Web 中使用 Matt Skills,需要把任務狀態從單輪會話中抽離出來。
- 任務涉及 Decisions、Spec、Tickets、Lanes、review 和驗收多個階段。
- 需要在中斷或 Harness 重啓後繼續工作。
- 需要導出脫敏證據,並在人工驗收前保留可檢查的過程記錄。
需要注意的幾點:
- 這是非官方 DeepSeek Harness 插件,安裝前應檢查源碼、依賴、許可證和發佈包來源。
- 插件運行在 DSH 環境中,建議把它視爲會繼承當前
dsh進程權限的組件。 - 插件不會 push、創建 pull requests、合併默認分支或刪除 dirty worktrees。
- 候選驗收僅限人工,並在寫入 Acceptance Receipt 前重新檢查 frozen candidate commit、review findings、Questions 和 Flow revision。
- GitHub Issues 發佈只在 Host 配置選擇
trackerKind: github且ghCLI 已認證時可用,且只創建 Issues,不執行其他 GitHub mutations。
鏈接¶
GitHub 倉庫:
https://github.com/hollis-openlab/dsh-matt-skills-flow
社區目錄線索(本文材料未確認該頁面):
https://www.skillhub.cn/plugins/hollis-openlab/dsh-matt-skills-flow