核心用法
git-workflow 是一套标准化的 Git 工作流自动化方案,覆盖代码提交、Pull Request 创建到版本发布的完整 DevOps 链路。核心功能包括:
代码提交自动化:强制遵循 Conventional Commits 规范(type(scope): message),支持 feat/fix/refactor/docs 等 11 种类型,自动推送到远程分支,无需二次确认。
PR/MR 智能创建:集成 GitHub CLI (gh),自动生成清晰的 PR 描述(主题+原因说明+验证步骤),禁止模板化堆砌和 AI 签名污染。
语义化版本发布:提供完整的 release checklist,自动处理版本号更新、CHANGELOG 生成、git tag 推送及 GitHub Release 创建。
多平台适配:自动识别 GitHub/Codeup/GitLab 远程仓库,针对阿里云 Codeup 会提示切换至 yunxiao 技能处理 MR。
显著优点
- 规范强制执行:内置 commit message 验证脚本,检查长度、语气、格式,从源头杜绝"feat: update"等低质量提交
- 零摩擦工作流:提交后自动 push,无需反复确认,减少心智负担
- 平台感知:智能识别远程 URL,自动选择最优 PR 创建路径
- 安全合规:明确禁止 AI 生成标记(
Co-Authored-By: Claude等),避免代码溯源污染
潜在局限
- 工具依赖:GitHub 功能需预装
ghCLI 并完成 OAuth 登录,新手配置成本较高 - GitLab 支持有限:Codeup 需跳转其他技能,GitLab.com 仅基础适配
- 单仓库局限:不处理多仓库批量同步场景(需使用 code-sync 技能)
适合人群
中高级开发者、技术团队负责人、需要维护开源项目的维护者,以及追求代码提交规范性的工程团队。
常规风险
- 强制推送风险:默认行为提交后自动 push,若未配置分支保护可能覆盖远程历史
- 权限依赖:
gh release create需仓库写权限,CI 环境需预先配置GH_TOKEN - 验证脚本依赖:Python 验证脚本需本地 Python3 环境,轻量容器环境可能缺失