dsh-matt-skills-flow:把 Matt Skills 變成可恢復的工程工作流

前言

在 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。

核心功能

插件主要提供以下能力:

  1. 創建 Flow 時快照已安裝的 Matt Skills 及其內容摘要。
  2. 在 Flow 中保留初始目標或 Bug 上下文,並以交互式生命週期圖可視化 review admission 和簡潔配置摘要。
  3. 在生成並批准 Spec 前記錄並取代 Decisions。
  4. 發佈依賴感知的 Ticket Graph,並預覽其可執行 Frontier。
  5. 默認將 Ticket Graph 發佈爲倉庫本地 Markdown;當 Host 配置選擇 trackerKind: github 且存在已認證的 gh CLI 時,發佈到 GitHub Issues。
  6. 從 Flow 擁有的集成分支創建隔離的 Lane 分支和 worktrees。
  7. 運行有界的 Lane Agents,將阻塞的 Questions 路由回根會話,並用新的 packet digest 重試。
  8. 順序集成完成的 Lanes,運行雙軸 Standards/Spec review,並要求人工驗收。
  9. 導出脫敏證據,並在 Harness 重啓後恢復中斷的工作。
  10. 提供簡體中文和英文本地化的 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 推進:

  1. 記錄 Decisions。
  2. 批准 Spec。
  3. 添加併發布 Tickets。
  4. 準備並運行 Lanes。
  5. 集成結果。
  6. review frozen candidate。
  7. 作爲人類驗收。

這套流程的目標是把任務推進到可驗收狀態,而不是隻完成一次代碼生成。

在會話中使用 /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 發佈需要滿足兩個條件:

  1. Host 配置選擇 trackerKind: github。
  2. 存在已認證的 gh CLI。

發佈時會驗證 gh 認證,並按依賴順序創建 Issues。插件不會執行其他 GitHub mutations。

適用場景與注意

這個插件適合以下情況:

  • 在 DSH Web 中使用 Matt Skills,需要把任務狀態從單輪會話中抽離出來。
  • 任務涉及 Decisions、Spec、Tickets、Lanes、review 和驗收多個階段。
  • 需要在中斷或 Harness 重啓後繼續工作。
  • 需要導出脫敏證據,並在人工驗收前保留可檢查的過程記錄。

需要注意的幾點:

  1. 這是非官方 DeepSeek Harness 插件,安裝前應檢查源碼、依賴、許可證和發佈包來源。
  2. 插件運行在 DSH 環境中,建議把它視爲會繼承當前 dsh 進程權限的組件。
  3. 插件不會 push、創建 pull requests、合併默認分支或刪除 dirty worktrees。
  4. 候選驗收僅限人工,並在寫入 Acceptance Receipt 前重新檢查 frozen candidate commit、review findings、Questions 和 Flow revision。
  5. GitHub Issues 發佈只在 Host 配置選擇 trackerKind: github 且 gh CLI 已認證時可用,且只創建 Issues,不執行其他 GitHub mutations。

鏈接

GitHub 倉庫:

https://github.com/hollis-openlab/dsh-matt-skills-flow

社區目錄線索(本文材料未確認該頁面):

https://www.skillhub.cn/plugins/hollis-openlab/dsh-matt-skills-flow
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜