前言¶
在 DeepSeek Harness（DSH）里用编码智能体写代码时，每个项目其实都有一套「开发工作流」：分支怎么命名、提交信息用什么格式、文档要不要跟代码一起改、发版前要满足哪些条件。这些约定往往写在 CONTRIBUTING 或团队文档里，真正改代码、提交、开 PR 的那一瞬间，智能体未必会翻到；没写死的约定则每个会话都要口头重复一遍，还容易漂移。
DSH 的生态思路是「一切皆插件」——能力以插件形式挂到运行时上，而不是换一套固定模式。@melosic/dsh-dev-workflow（维护者 Melosic）把上述工作流打包成插件：规范以 skill 按需注入，能机械检查的部分交给工具，不能撤销或会对外可见的操作先过闸门。下面介绍它是什么、能做什么，以及如何安装与确认生效。
这是什么¶
@melosic/dsh-dev-workflow 是面向 DSH 的开发工作流守门与编排插件（package 描述：Development-workflow gatekeeper and orchestrator plugin for DSH）。它在你已有的 DSH 模式之上工作，本身不是替代某种 mode 的新 mode。
插件把分支模型、Conventional Commits、原子提交、PR 质量门槛、文档同步、发布与 CHANGELOG 等约定，整理成智能体按需读取的 skill；常驻上下文只占少量 token。README 说明：可机械校验的由工具执行；不可撤销、或未经你同意就不该对外展示的操作，在发生前触发 guard 或审批。
当前 npm 包版本为 0.4.0，许可证 MIT（© 2026 Melosic）。源码与说明见 GitHub 仓库；社区目录页为 SkillHub 上的 Melosic/dsh-dev-workflow（独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
以下能力均来自项目 README 与 package 元数据，按模块归纳。
规范以 skill 注入，而非每轮长文说教¶
完整工作流规范在需要时才被读取；平时留在上下文里的只是一小段摘要，避免每个 turn 都重复同一篇指南。
两个检查工具¶
check_commit_message：校验提交信息是否符合 Conventional Commits。check_doc_sync：检查文档是否随代码变更而同步更新。
三个触发点（平时安静，到节点才说话）¶
- 执行
git commit之前。 - 执行
gh pr create之前。 - 执行
git tag或发布相关操作之前。
五类 guard（统一形态）¶
README 归纳为五类防护：不可恢复的 shell 命令、破坏性 git 操作、他人可见的操作、敏感路径读取、参数中的凭证信息。例如 git clean -f 这类受 guard 保护的操作不会静默执行：会提示审批，或在关闭审批时被直接拒绝。
开关与设置¶
- 斜杠命令
/dev-workflow status：报告当前 mode、locale、最近一次检查与 guard 活动等信息；off可注销插件注册的全部能力。 - DeepSeek Harness Settings 中提供设置面板，各开关与枚举项可改且无需重启即生效。
环境要求¶
| 组件 | 版本 |
|---|---|
| DeepSeek Harness runtime | >=0.2.0-rc.2 |
| Node.js | >=20 |
| pnpm | 10.x |
README 特别说明：不支持的 DSH 版本不会导致安装失败，而是会禁用插件——插件仍被安装，但不会在界面中出现。提 issue 前请用 dsh --version 对照上表；版本选择逻辑见仓库内 docs/PUBLISHING.md。
插件开发本身使用 pnpm@10.30.3（见 package.json 的 packageManager 字段）。
安装与启用¶
请使用 DSH 官方安装器，而不是对插件目录单独 npm install：profile 只会加载其 dsh.profile.bundles 里列出的 bundle，安装器会同时写入依赖与该列表项。
dsh plugin --profile <profile> add @melosic/dsh-dev-workflow
将 <profile> 换成你实际使用的 profile 名称。
安装后在 DSH 中执行：
/dev-workflow status
应能看到 mode、locale、最近检查、guard 计数与审计日志状态等。可再试一条受 guard 保护的操作（如 git clean -f），确认会出现审批提示或按你的设置被拒绝，而不是无提示执行。
若要自行改插件源码，README 指向 CONTRIBUTING.md。
典型用法与文档入口¶
日常开发中，智能体在提交、开 PR、打 tag 或发布前会命中对应 trigger；提交信息与文档同步则分别由 check_commit_message、check_doc_sync 协助把关。具体约定全文在插件自带的 skill 中，随场景按需加载。
仓库文档索引（README 列出）：
- docs/README.md — 文档总索引与阅读路径。
- CHANGELOG.md — 发布记录（Keep a Changelog 格式）。
- CONTRIBUTING.md — 本地搭建、分支、提交与贡献流程。
适用场景与注意¶
适合谁： 已在 DSH 中用编码智能体做日常开发，希望把团队或个人的 Git/PR/文档/发布规范「写进运行时」、并在 commit / PR / tag 等节点自动校验与拦截的团队或个人。
权限与安全： 插件与当前 dsh 进程使用相同权限运行。安装前应阅读 源码仓库 与 MIT 许可证，确认 guard 与 trigger 行为符合你的环境与合规要求。
与旧习惯的对比： 若仅依赖口头 prompt 或静态 AGENTS.md，规范容易在会话间漂移；本插件把规范 skill 化，并把可检查项工具化、把高风险操作 guard 化，减少「说了但没做到」的情况。
结尾¶
@melosic/dsh-dev-workflow 把开发工作流从「文档里的一段话」变成 DSH 里可开关、可审计的插件能力：按需 skill、两项检查、三处触发、五类 guard，以及 /dev-workflow status 与 Settings 面板。若你正在整理智能体协作下的 Git 与发布纪律，可从官方安装命令装好 profile，用 status 与一次受 guard 的操作验证行为是否符合预期。
- 目录页：https://www.skillhub.cn/plugins/Melosic/dsh-dev-workflow
- GitHub：https://github.com/Melosic/dsh-dev-workflow
