SuperAPI AI 工具集

git-workflow

办公与效率

查看项目

更新于 10-16 09:28

技能介绍

用途:帮助团队建立 Git 分支策略、拉取请求(PR)流程与发布管理规范,改善代码评审实践。适用场景包括制定团队 Git 工作流、配置 PR 流程、搭建发布管理、优化代码评审。前提条件:已安装 Git、有代码托管平台(GitHub、GitLab、Bitbucket)以及基础 Git 知识。

主要能力: 一、分支策略。主干开发适合持续部署、小团队与成熟 CI/CD,使用短生命周期功能分支,示例命令:git checkout main、git pull origin main、git checkout -b feature/add-login、git fetch origin、git rebase origin/main、git merge feature/add-login。GitHub Flow 适合持续交付与 Web 应用,从 main 建分支、推送并创建 PR、评审后合并(推荐 squash)、合并后删分支。GitFlow 适合计划发布与版本化产品,使用 git flow init、git flow feature start/finish、git flow release start/finish、git flow hotfix start/finish。 二、提交规范。约定式提交格式为 <type>(<scope>): <description>,类型含 feat、fix、docs、style、refactor、test、chore,破坏性变更使用 ! 与 BREAKING CHANGE 说明;可配置提交模板 git config --global commit.template ~/.gitmessage。 三、PR 流程。提供 PR 模板、分支保护规则(必需评审、状态检查、线性历史等)和 .github/CODEOWNERS 示例。 四、Git Hooks。给出 pre-commit 脚本示例,以及通过 Husky 与 lint-staged 配置 pre-commit、commit-msg 钩子,配合 commitlint 校验提交信息。 五、发布流程。包括创建带注释标签 git tag -a v1.0.0、推送标签、使用 gh release create 创建发布、用 conventional-changelog 或 git cliff 生成变更日志。 六、常用操作与问题处理。涵盖 rebase 与 merge 的选择、cherry-pick、交互式 rebase,以及合并冲突、分支分叉、误提交到错误分支的处理思路。

最佳实践:分支保持短生命周期(少于一周)、写有意义的提交信息、一致使用 PR 模板、要求代码评审、保护 main/master 分支、用 CI 自动化检查、用 squash 合并保持历史整洁、合并后删除分支。相关技能:semantic-versioning、github-actions、feature-flags。

限制:该文档为纯文档导入,未附带上游脚本与模板;相关指引会作用于真实环境,执行前需确认目标、影响范围与回滚方案,未经明确批准不得部署到生产环境。