前言¶

在 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