前言¶

在 DeepSeek Harness（DSH）裏做交付型項目時，階段、負責人、驗收標準往往散落在口頭同步、工單和臨時文檔裏。人和模型要回答「誰負責什麼」「什麼叫完成」「卡在哪一階段」，常常得先翻聊天記錄或問 PM。若交付狀態不能和代碼同倉、同版本演進，智能體也很難穩定讀寫同一份上下文。

dsh-delivery-board 是社區維護者 jerryxff26-alt 發佈的 DSH 插件（SkillHub 分類：工作流）。它把階段流水線、交接審計和麪向客戶的週報寫進倉庫內的交付狀態；看板、審計視圖和週報都是同一份狀態的投影，而不是獨立的外部服務。插件在 GitHub 上約 3 stars，當前 package 版本爲 0.1.3，許可證 MIT，文檔記載在 DSH 0.2.0-rc.2（developer preview）下做過驗證，無額外運行時依賴。

這是什麼¶

一句話：Codebase-native delivery context——交付狀態與源碼同在倉庫，PM、工程、QA 與 AI 智能體共享同一 Source of Truth。

設計原則（來自官方 README）可以概括爲四點：交付狀態是一等公民；各類視圖只是投影；日常通過 DSH 的 /delivery 或自然語言操作，而不是手改 JSON；邊界清晰，不試圖復刻企業級項目管理平臺，只保留當前倉庫真正需要的交付上下文。

核心功能¶

下面只列資料中已明確說明的能力。

階段流水線與卡片¶

• 每張卡片包含負責人、截止日期、驗收標準（AC）與 Definition of Done（DoD）。
• 初始化後可增刪改階段名；若階段內仍有卡片，刪除階段會被拒絕（需先遷移卡片）。

交接審計（Handoff audit trail）¶

卡片跨階段移動時，自動記錄「誰把什麼交給了誰」。

客戶週報（Weekly report）¶

生成 Markdown 格式週報，內容包括：流水線快照、當週交接記錄、未解決的風險/阻塞項（已解決項不寫入）。可選「下週說明」；爲空時該節省略。

本地可編輯看板¶

通過 /delivery Open the editable board（或等價自然語言）可在 127.0.0.1 打開支持拖拽的本地看板，寫回同一份交付狀態。看板支持歸檔/恢復、風險與阻塞記錄、可跟蹤的門禁清單（gate checklists）。無障礙備選：Edit → Stage；界面語言隨瀏覽器（含 zh-CN）。

離線 HTML 快照¶

生成只讀單文件 HTML，未安裝 DSH 的同事也可打開查看。

內置 delivery Skill 與工具鏈¶

插件註冊 delivery skill：輸入 /delivery 加目標描述，由模型按 skill 說明推理，底層 delivery_* 工具負責校驗、持久化、記錄交接與渲染視圖。模型推理，工具落盤。 原先的直接 /delivery 命令已改爲 /delivery-admin，避免與 skill 衝突；已有腳本需改前綴，交付數據無需遷移。

常用工具（README 工具表）包括：delivery_init、delivery_card、delivery_move、delivery_board、delivery_open、delivery_update、delivery_archive 等（資料在截斷處未列全表，以倉庫 README 爲準）。

流水線模板¶

亦可通過 stages 參數完全自定義階段。門禁爲可跟蹤清單（持久化爲 gateDone），不硬阻塞卡片移動。

安裝與啓用¶

CLI 安裝命令（README 原文）：

dsh plugin --profile web add github:jerryxff26-alt/dsh-delivery-board

桌面端可在插件管理器中使用同一 GitHub 規格 github:jerryxff26-alt/dsh-delivery-board 安裝（README 註明 CLI 爲已驗證路徑，桌面流程未單獨驗證）。

啓用注意：

• 需要 Node >=20；peer 依賴 @deepseek-ai/dsh-tools >=0.2.0-rc.2 <0.3.0。
• 鏈接桌面開發時，更新插件後需完全退出並重啓 DSH；依賴 DSH 的 skills 服務與 tool-skill loader。確認插件狀態爲 Running。
• /delivery <請求> 走 skill；/delivery-admin 走直接命令處理器。

插件以當前 DSH 進程權限運行。安裝前請自行查閱 GitHub 倉庫 源碼與 MIT 許可證，評估是否適合你的環境。

典型用法¶

模型主導的 Skill 工作流（推薦）¶

無需單獨複製 skill，插件已打包註冊。示例（README 原文）：

/delivery Review this repository and propose a delivery plan for ACME from its requirements and tests.
/delivery Create the cards from the approved plan; leave unknown owners and dates unset.
/delivery Hand off the API integration card to Test, assign Morgan, and summarize the available evidence.
/delivery Open the editable board.
/delivery Prepare the client weekly report for the week starting 2026-10-05.

流程上：skill 讀取倉庫上下文、識別缺口並提議階段與卡片內容；delivery_init 仍確定性創建空項目；計劃在批准後再批量建卡。

高級：確定性命令（不經過模型）¶

/delivery-admin help
/delivery-admin init {"customer":"Demo","template":"governance"}
/delivery-admin card {"title":"API integration","stage":"build","owner":"Alice"}
/delivery-admin board
/delivery-admin open
/delivery-admin move c1 test
/delivery-admin update {"card_id":"c1","owner":"Bob","due":"2026-10-20"}
/delivery-admin archive c1
/delivery-admin restore c1
/delivery-admin weekly 2026-10-05
/delivery-admin html

init、card、update、log 等接受 JSON 對象；move 也可帶 JSON 以變更負責人或交接說明。

適用場景與注意¶

適合誰

• 希望在單倉庫內跑完整交付生命週期、且需要人與 AI 共用同一交付上下文的團隊。
• ToB 或治理型流水線（default / governance 模板）與週報、交接審計有剛性需求的場景。
• 需要本地拖拽看板但又要把狀態寫回 Git 的工作方式。

注意

• 這不是 Jira/企業 PM 的替代品；能力邊界 intentionally 收窄在「代碼庫需要的交付上下文」。
• 社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本插件是其中一條工作流擴展。
• 項目級 skill 可按 DSH 常規優先級覆蓋插件內置 skill。

結尾¶

dsh-delivery-board 把階段看板、交接審計和客戶週報統一到倉庫內交付狀態，通過 /delivery skill 與 delivery_* 工具分工，讓模型負責理解與規劃、工具負責校驗與持久化。若你正在 DSH 裏做交付型智能體或人機協作開發，可按上文命令安裝並在倉庫內初始化流水線。

• 目錄頁：https://www.skillhub.cn/plugins/jerryxff26-alt/dsh-delivery-board
• 源碼與文檔：https://github.com/jerryxff26-alt/dsh-delivery-board