Agent Skills
返回列表
Git 工作流

Git 工作流

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的指引,安装 @zcwl/git-workflows

技能介绍

解决哪些开发痛点

长期协作中 Git 历史容易混乱,多发功能导致提交记录杂乱,合并前清理历史困难;线上出现 bug 时手动回溯提交定位原因耗时长;同时开发多分支需要反复切换上下文,物理隔离不足;误删提交或错误操作后难以恢复;跨仓库共享代码时子模块与子树的取舍不明确;大型 monorepo 全量克隆导致本地存储和检出缓慢;合并冲突反复出现,处理流程繁琐。

核心能力与关键操作

该技能提供进阶 Git 操作指引:

  • 交互式变基:通过 git rebase -i 压缩、重排提交,autosquash 自动整理补丁,合并前整理出干净的主线历史。
  • 二分定位:使用 git bisect 对提交范围进行二分搜索,配合 git bisect run 和测试脚本自动判断缺陷引入点,支持构建失败场景。
  • 工作树:通过 git worktree 创建并行分支工作目录,共享 .git 存储,避免多克隆开销。
  • 历史恢复:git reflog 记录所有提交历史,误操作后可在 90 天内恢复丢失的提交或撤销错误操作。
  • 跨仓库管理:git subtree 复制代码到本地仓库简化协作,git submodule 指向特定提交的外部仓库;通过对比场景选择合适方案。
  • 稀疏检出:git sparse-checkout 仅检出需要的目录,适用于大型 monorepo,减少本地存储占用。
  • 冲突解决:理解冲突标记,结合 git rerere 记录已解决的冲突,避免重复处理相同问题;支持 rebase 冲突处理流程。
  • 辅助操作:git stash push -m "描述" 带说明保存工作栈,git log -S "字符串" 快速定位代码添加或删除的提交,git blame 追溯行级变更,标签和发布管理规范版本节奏。

使用边界与注意事项

  • 禁止对已推送到共享分支的提交执行 rebase,仅在本地特性分支上使用。
  • 除非有明确理由,优先选择 git subtree 而非 git submodule,降低协作复杂度。
  • 全局启用 git rerere,避免重复解决相同的合并冲突。
  • 使用 git stash 时附带说明消息,便于后续识别工作栈内容。
  • 善用 git reflog 作为安全网,减少误操作风险。

使用场景

  • 准备合并特性分支前,需要清洗提交历史:使用交互式变基压缩、重排提交,保留主线整洁。
  • 线上版本出现错误,需要定位引入缺陷的提交:通过二分搜索配合测试脚本自动定位责任提交。
  • 单仓库需要并行开发两条特性,同时避免克隆整个仓库:利用工作树创建独立工作目录隔离上下文。
  • 误删除未推送提交或错误重置本地分支,需恢复代码:使用引用日志在90天内快速找回提交。

适合人员

  • 后端开发工程师:日常编写业务逻辑,需要在提交合并前整理杂乱的提交记录。
  • 前端开发工程师:负责页面组件开发,经常需要并行处理多个特性分支与联调。
  • 项目技术负责人:审查代码质量与发布节奏,需要排查提交缺陷与管理集成合并。
  • 开源项目维护者:维护单一仓库生态,需要处理外部贡献者的提交与冲突协调。