Git 工作流
将以下提示词粘贴到你的 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天内快速找回提交。
适合人员
- 后端开发工程师:日常编写业务逻辑,需要在提交合并前整理杂乱的提交记录。
- 前端开发工程师:负责页面组件开发,经常需要并行处理多个特性分支与联调。
- 项目技术负责人:审查代码质量与发布节奏,需要排查提交缺陷与管理集成合并。
- 开源项目维护者:维护单一仓库生态,需要处理外部贡献者的提交与冲突协调。