dsh-dev-workflow

English | 简体中文

面向编码 Agent 的一套开发工作流，以 DeepSeek Harness （dsh）插件的形式分发：一份按需读取的规范，负责执行其中可机械检查部分的两件工具与三个触发器，以及守住不可撤销动作、或不该在你点头之前就对外宣称的动作的几道守卫。它是插件，不是模式——在你已经在用的模式之上工作。

为什么需要它

每个项目都有一套开发工作流：分支怎么起名、提交信息怎么写、文档什么时候跟着代码改、发版前必须满足什么。写下来，这些约定就躺在贡献者指南里，在该用的那一刻没人会去翻——Agent 尤其不会；不写下来，就得每个会话重说一遍，而且会漂移。

这个插件把这套规范变成 Agent 随身带着、工具负责执行的东西。整套流程——分支模型、提交信息格式、原子提交、PR 质量门禁、文档同步、发版与 CHANGELOG 规则——以技能形式随包分发、按需读取，该用的时刻就在手边，又不必每轮常驻。能机械检查的替你检查；不能撤销的先拦下，其他人会看见、而你还没点头的也先问过。它只在这些时刻说话，其余时候不吭声。

功能特性

规范以技能形式按需读取，而不是每轮说教。 常驻的只有一段几百 token 的摘要。
两个检查工具。 check_commit_message 校验提交信息，check_doc_sync 检查文档是否跟着代码一起改。
三个触发器，平时不吭声： 提交前、gh pr create 前、git tag 或发布前。
五道守卫，一个形状。 不可逆的 shell 命令、危险的 git 操作、其他人看得见的对外动作、敏感文件读取、参数里的真实凭据。
一个开关，而且是安装开关。 /dev-workflow status 报告模式、语言、最近一次检查与守卫命中；off 会把注册全部注销。
DeepSeek Harness 设置里的可视化面板，所有开关与枚举都能改，保存后无需重启。

环境要求

组件	版本
DeepSeek Harness 运行时	`>=0.2.0-rc.2`
Node.js	`>=20`
pnpm	`10.x`

DeepSeek Harness 版本不在支持范围内，不会让安装失败——它会把这个插件静默禁用，症状是「装上了但从来不出现」。报 bug 之前先用 dsh --version 对一下上面的版本范围； docs/PUBLISHING.md 说明了范围怎么定，以及按 profile 开的那个应急口子。

快速开始

# 克隆并安装
git clone https://github.com/Melosic/dsh-dev-workflow.git
cd dsh-dev-workflow
pnpm install

# 构建与校验
pnpm build
pnpm typecheck
pnpm lint
pnpm test

然后把插件安装到你的 DeepSeek Harness profile：

dsh plugin --profile <profile> add @melosic/dsh-dev-workflow

若想从本地检出安装，把插件管理器指向本包目录即可。想确认插件真的在工作，在 DeepSeek Harness 里执行 /dev-workflow status：它会打印当前模式、语言、最近一次检查、守卫命中次数与审计日志状态。再试一个该被拦下的动作——比如在随便一个仓库里跑 git clean -f——它会先问你，而在关掉审批的会话里直接拒绝。

dsh-dev-workflow

Install

Source

Tags

Creators

Readme

dsh-dev-workflow

为什么需要它

功能特性

环境要求

快速开始

文档链接

贡献指引

许可证