前言¶
在 DeepSeek Harness（DSH）里让 agent 帮忙改代码时，常见情况是：每次开分支、写 commit message、提 PR 或打 tag，都要临时口述一套流程，agent 也容易按通用习惯而不是团队约定行事。托管平台、CI 各自不同，但 Git 本地的分支模型、Conventional Commits、评审顺序、历史改写与误操作恢复，往往可以事先写进文档并让 agent 按同一套纪律执行。
下面介绍社区插件 dsh-git-workflow（npm 包名 @jojonadam/dsh-git-workflow，仓库 JOJO-Adam/dsh-git-workflow）。装好之后，agent 在开分支、写提交、提 PR、发版本之前会先按你们自己的规矩走，而不是每次现编一套。插件归类为「工作流」，维护者为 JOJO-Adam（作者署名 JOJO & Adam）；当前 package 版本为 0.1.0，许可证 MIT。DSH 生态采用「一切皆插件」思路，目录页在 skillhub.cn，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-git-workflow 的定位是：面向 DeepSeek Harness 的 Git workflow studio——把分支模型、提交规范、PR 评审、历史 surgery、灾难恢复、发布版本等能力，以约 7 个 skill（README 与 package 描述中亦称「六本手册」）的形式交给 agent 调用。它只覆盖 Git 本身，不替你们选托管平台，也不碰 CI 配置的具体实现。
核心功能¶
以下能力均来自插件 README 与 package 描述，安装后 agent 可在相关场景下引用对应技能。
- 定流程：版本基线、分支模型决策树、协作流程、提交/评审/发布纪律，一次说清。
- 统一提交：Conventional Commits 的 type/scope 约定，含破坏性变更怎么写。
- 评 PR：PR 描述模板、按缺陷密度排序的评审顺序、合并前检查清单。
- 改历史：交互式 rebase、squash 与 fixup 的取舍、cherry-pick 区间，以及「已 push 就别动」的红线。
- 救火：reflog 找回丢失的提交、恢复误删分支、reset 错了怎么办。
- 发版本：按实际行为变化定 semver，打 tag 与发布流程。
边界：破坏性操作提供的是判断与命令清单，执行前由你确认，插件不会自动跑危险命令。
安装与启用¶
插件要求 DSH >=0.2.0-rc.2、Node >=20，并声明 peer 依赖 @deepseek-ai/cordis ~4.0.5。安装前建议阅读仓库源码与 LICENSE，并知晓插件以当前 dsh 进程权限运行。
Web 版与桌面版使用同一包名，通过 profile 区分：
# Web 版
dsh plugin --profile web add @jojonadam/dsh-git-workflow
# 桌面版
dsh plugin --profile desktop add @jojonadam/dsh-git-workflow
典型用法¶
怎么触发：直接用自然语言即可，也可以显式点名技能。README 给出的示例如下：
- 「这次改动该升 major 还是 minor」
- 「帮我把这三个提交压成一个」
- 「我把分支删了怎么找回」
经过上面的步骤，agent 会在动手前对齐你们文档里的分支与提交纪律，而不是临时拼凑一套 Git 命令。
适用场景与注意¶
适合谁：需要在 DSH 对话里稳定复用 Git 纪律的团队或个人——尤其是已经采用或打算采用 Conventional Commits、固定 PR 评审顺序、semver 发版，但又不想每次手动粘贴 wiki 的场景。
注意：
- 不替代 GitHub/GitLab 等平台侧的 PR 按钮与保护分支策略；只约束 agent 如何建议、如何列出命令。
- 历史改写、reset、force 等操作务必人工确认后再执行。
- 社区目录与 GitHub 星标（截至资料抓取时为 0）仅作发现与溯源，不代表官方背书。
结尾¶
dsh-git-workflow 把 Git 工作流从「每次口头交代」变成装插件即可调用的技能集：流程、提交、评审、改历史、恢复、发版各有一块。若要查看简介与安装入口，可打开 SkillHub 目录页；细节与 issue 见 GitHub 仓库。
