适用场景

当任务涉及 Git 仓库、分支、提交、合并、变基、拉取请求、冲突解决、历史查看或恢复时，请使用本技能。该技能为无状态设计，只要工作内容包含 Git 操作，即应默认启用。

快速参考

核心规范

1. 禁止对共享分支强制推送（force push） — 仅可在功能分支上使用 --force-with-lease
2. 尽早提交，频繁提交 — 小粒度提交更易于审查、回退和二分定位（bisect）
3. 编写有意义的提交信息 — 首行不超过 72 字符，采用祈使语气（imperative mood）
4. 推送前先拉取 — 推送前始终执行 git pull --rebase，避免产生不必要的合并提交
5. 合并前清理提交记录 — 使用 git rebase -i 合并（squash）临时修复类提交（如 fixup）

团队协作流程

功能分支流程（Feature Branch Flow）：

1. 从 main 分支创建新分支：git checkout -b feature/name
2. 持续开发并定期推送提交
3. 发起 PR 并获取代码评审
4. 将功能分支以 squash 方式合并至 main
5. 删除本地及远程的功能分支

热修复流程（Hotfix Flow）：

1. 从 main 分支创建热修复分支：git checkout -b hotfix/issue
2. 修复问题、测试并通过提交固化
3. 同时合并至 main 和 develop（若存在）
4. 为本次发布打标签（tag）

日常同步（Daily Sync）：

git fetch --all --prune
git rebase origin/main  # 若团队偏好合并策略，可替换为 git merge

提交信息规范

• 采用约定式提交格式（Conventional Commits）：type(scope): description
• 首行长度控制在 72 字符以内
• 支持的类型包括：feat、fix、docs、style、refactor、test、chore

推送安全规范

• 使用 git push --force-with-lease 替代 --force —— 可防止覆盖他人工作成果
• 若推送被拒绝，应先运行 git pull --rebase 再重试
• 严禁对 main/master 分支执行强制推送

冲突解决要点

• 编辑完冲突文件后，确认已清除所有冲突标记：grep -r "<<<|>>>|===" .
• 完成合并前，务必验证代码可正常构建
• 若合并过程过于复杂，可执行 git merge --abort 中止，并改用 git rebase 尝试

分支整洁规范

• 本地删除已合并分支：git branch -d branch-name
• 清理远程追踪引用：git fetch --prune
• 发起 PR 前，先将功能分支基于最新 main 进行变基（rebase）
• 推送前使用 git rebase -i 整理杂乱提交（如多个临时提交）

安全检查清单

执行破坏性操作（如 reset --hard、rebase、force push）前，请逐项确认：

• 当前是否为共享分支？→ 禁止重写其历史
• 是否存在未提交的更改？→ 先暂存（stash）或提交
• 当前所在分支是否正确？→ 使用 git branch 核实
• 远程仓库是否已同步？→ 先执行 git fetch

常见陷阱

• Git 用户邮箱配置错误 — 提交关键代码前，请用 git config user.email 核查
• 空目录无法被 Git 跟踪 — 可添加占位文件 .gitkeep
• 子模块（Submodules） — 克隆时务必使用 --recurse-submodules 参数
• 分离头指针（Detached HEAD） — 使用 git switch - 快速返回上一个分支
• 推送被拒绝（Push rejected） — 多数情况下需先执行 git pull --rebase
• 冲突状态下执行 stash pop — stash 将丢失；推荐改用 stash apply
• 大文件处理 — 文件体积超过 50MB 时请使用 Git LFS；严禁提交密钥等敏感信息
• 大小写敏感问题 — macOS / Windows 默认忽略路径大小写，Linux 则严格区分，易导致 CI 构建失败

恢复命令

• 撤销最后一次提交但保留工作区更改：git reset --soft HEAD~1
• 丢弃未暂存的修改：git restore filename
• 查找丢失的提交：git reflog（默认保留约 90 天操作历史）
• 恢复已删除分支：git checkout -b branch-name
• 当单次提交混杂多项变更时，使用 git add -p 进行交互式部分暂存

使用 Bisect 进行调试

定位引入缺陷的具体提交：

git bisect start
git bisect bad                    # 当前提交存在缺陷
git bisect good v1.0.0            # 该版本功能正常
# Git 将检出中间提交，请测试后执行：
git bisect good                   # 或 git bisect bad
# 重复上述步骤，直至 Git 定位到问题提交
git bisect reset                  # 恢复至原始分支

常用命令速查

git status -sb                    # 简洁状态输出（含当前分支）
git log --oneline -5              # 查看最近 5 次提交
git shortlog -sn                  # 按提交次数统计贡献者
git diff --stat HEAD~5            # 统计最近 5 次提交的变更摘要
git branch -vv                    # 显示所有分支及其追踪关系
git stash list                    # 列出当前暂存栈

相关技能

若用户确认安装，可执行：clawhub install

• gitlab — GitLab CI/CD 与合并请求（Merge Requests）支持
• docker — 容器化工作流支持
• code — 代码质量与最佳实践指南

反馈

• 若本技能有用，请执行：clawhub star git
• 保持更新，请执行：clawhub sync