SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场git-workflow

git-workflow

编程与开发

查看项目

更新于 10-16 02:23

技能介绍

用途

Git Workflow 是一套面向团队开发的现代 Git 协作模式集合，用于帮助团队选择分支模型、规范 PR 流程、统一提交约定，并加固仓库设置以实现安全协作。其核心目标是让分支策略、评审纪律、提交规范与自动化质量门禁形成一致的工作方式。

主要能力

  • 分支策略选择：提供决策树，依据团队规模、发布节奏与 CI/CD 成熟度，在 GitHub Flow、主干开发（Trunk-Based Development）与 GitFlow 之间做出选择，并给出迁移路径。
  • PR 最佳实践：包含 PR 规模建议（常以 200-400 行为宜）、评审分类（BLOCKER、WARNING、NITPICK）、评审礼仪与 PR 描述模板（What、Why、How、Testing）。
  • 提交约定：采用 Conventional Commits 格式 type(scope): description，支持语义化版本自动升级与变更日志生成，涉及 commitlint、semantic-release、standard-version 等工具。
  • 堆叠式 PR（Stacked Diffs）：将大型功能拆分为可评审的小块，适用于超过 500 行的功能或复杂重构，涉及 GitLab MR 链与 Graphite CLI。
  • 交互式 rebase 与历史清理：支持 fixup!/squash! 自动压缩、拆分提交、重排提交，并强调不要对公共分支执行 rebase。
  • 冲突解决：涵盖 --ours、--theirs、手动合并、rebase 与 merge 的取舍、合并工具配置与冲突标记理解。
  • 自动化质量门禁：包括测试、覆盖率、lint、安全扫描、性能基准、包体积与无障碍检查，涉及 GitHub Actions、GitLab CI 与 Husky + lint-staged 预提交钩子。
  • 验证清单：提供 PR 前、合并前、发布前、部署后与热修复清单。
  • 发布管理：语义化版本 MAJOR.MINOR.PATCH、手动与自动发布流程、热修复流程与变更日志格式。
  • 仓库基线加固：分支保护、评审门禁、CODEOWNERS、签名提交与标签、密钥防护、合并队列与 CI 成本控制。
  • 其他主题：Monorepo 工作流、Git 钩子自动化、git bisect 调试、常见错误与反模式。

使用方式

快速开始步骤为：识别约束（团队规模、发布节奏、CI 成熟度、合规要求）；使用决策树选择分支策略；应用仓库基线设置（分支保护、审批、检查、合并策略）；再查阅对应参考文档获取实现细节。技能提供快速参考表，将任务、命令与参考文档对应，例如创建功能分支 git switch -c feat/name main、压缩 WIP 提交 git rebase -i HEAD~3、安全强制推送 git push --force-with-lease、创建堆叠 PR gt create stack-name（Graphite）、自动生成变更日志 npx standard-version。

针对 AI 辅助工程，推荐默认循环：每个功能分支创建一个 worktree；仅实现该功能范围内的变更；PR 前运行仓库质量门禁；向集成分支提交一个聚焦的 PR。若仓库存在脚本（如 scripts/git/feature-workflow.sh），可用其强制执行该循环。

本地安全检查流程包括：用 git status --porcelain 检查工作区是否干净；若 Git 命令因 index.lock 失败，先检查运行中的 Git 进程；避免在本地变更会被覆盖时切换分支；冲突时停止新编辑，逐文件解决并重跑测试后再完成合并提交。

适用场景

适用于需要标准化协作流程的开发团队，尤其是希望根据团队规模与发布节奏选择合适分支模型、提升代码评审效率、统一提交信息、加固仓库安全设置，以及为大型功能引入堆叠式 PR 的场景。也适用于 AI 辅助工程中需要约束分支与 PR 流程的团队。

限制

资料中明确说明：AI 工具可辅助但不能替代人类对合并决策的判断；AI 摘要需要人工验证；风险标签仅为建议而非保证；合并决策始终需要人工批准。此外，资料提示在回答关于 Git 工作流、分支策略或协作工具的最新推荐问题时，应通过网页搜索验证当前趋势，而非仅依赖静态知识。资料未提供该技能的具体收费、价格、平台支持范围或效果数据。