yangyongzhen/dsh-git-workflow
规范提交(Conventional Commits)、自动 changelog、PR 描述生成与分支推送,纯 git CLI 实现。
Bundle 已验证
未知
JavaScript
未知
Bundle 已验证
已收录
1
Git
Bundle 已验证
★ 1
在 GitHub 查看
预览
功能介绍
规范提交(Conventional Commits)、自动 changelog、PR 描述生成与分支推送,纯 git CLI 实现。
适合
- 需要在提交前强制校验 Conventional Commits 格式的团队。
- 需要根据本地提交历史和 diff 生成 changelog 与可直接粘贴的 PR 描述的 Git 工作流。
- 希望仅通过原生 Git CLI 在 GitHub、GitCode 或其他 Git 远端完成状态检查、提交和分支推送的开发者。
不适合
- 不使用 Git 仓库的工作流。
- 需要插件通过代码托管平台 API 创建或管理 PR 的团队;它只生成 PR 摘要,不使用平台 API。
- 需要覆盖提交校验、changelog、PR 文本和分支推送之外完整发布管理的流程。
README
dsh-git-workflow
DeepSeek Harness Git 工作流插件:规范提交(Conventional Commits)、自动 changelog、PR 描述生成、分支推送——纯 git CLI,兼容 GitCode / GitHub / 任何 git 远端,无需平台 API 或 token。
安装
dsh plugin --profile <name> add dsh-git-workflow
# 或从本地 checkout 安装
cd ~/dsh-git-workflow && dsh plugin --profile <name> add .
配置
- id: git-workflow
config:
enabled: true
workdir: '' # 可选;默认会话工作目录
conventional: true # 强制 Conventional Commits 规范
defaultBranch: main
工具(对话中自动调用,无需命令)
| 工具 | 作用 |
|---|---|
git_status |
分支 / 与上游领先落后 / 已暂存·未暂存·未跟踪文件 / 最近提交 |
git_commit |
校验 Conventional Commits 格式(feat|fix|docs|…(scope)?: subject,破坏性变更加 !),可选 all=true 先暂存全部再提交 |
git_changelog |
生成按类型分组的 Markdown 变更日志;from 默认最近 tag |
git_pr_summary |
生成 PR 标题建议 + 描述模板(提交列表 / diff 统计 / 破坏性变更) |
git_push |
git push -u <remote> <branch> 推送并设置上游 |
示例对话:
我:帮我把这次改动提交了
Agent:git_status → 发现 3 个文件变更 → git_commit message="feat: add login flow"
我:生成一个 PR 描述
Agent:git_pr_summary base=main → 输出可直接粘贴的 Markdown
开发
pnpm install && pnpm build
node test/git-workflow.test.mjs # 临时仓库端到端:状态/规范提交/changelog/PR/推送
License
MIT
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:yangyongzhen/dsh-git-workflow。命令会解析公开 package 元数据,并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到,请先保持禁用,并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页,确认目录已经观察到最新版本。