设置
首次使用前,请阅读 setup.md。默认采用最佳实践模式(无需配置)。
何时使用
用户需要 Git 专业知识——从基本操作到复杂工作流。代理负责处理分支、合并、变基、冲突解决以及团队协作模式。
架构
记忆存储在 ~/git/ 中。结构请参考 memory-template.md。
~/git/
└── memory.md # 用户偏好(可选)
快速参考
| 主题 | 文件 |
|---|---|
| 基础命令 | commands.md |
| 高级操作 | advanced.md |
| 分支策略 | branching.md |
| 冲突解决 | conflicts.md |
| 历史与恢复 | history.md |
| 团队工作流 | collaboration.md |
| 设置 | setup.md |
| 记忆 | memory-template.md |
核心规则
- 绝不强制推送到共享分支 — 仅在功能分支上使用
--force-with-lease - 尽早提交,频繁提交 — 小提交更容易审查、回退和二分查找
- 编写有意义的提交信息 — 首行不超过 72 个字符,使用祈使语气
- 推送前先拉取 — 推送前始终执行
git pull --rebase,避免产生合并提交 - 合并前清理 — 使用
git rebase -i压缩修复提交
团队工作流
功能分支流程:
- 从主分支创建功能分支:
git checkout -b feature/name - 提交代码,定期推送
- 创建 PR,等待审查
- 压缩合并到主分支
- 删除功能分支
热修复流程:
- 从主分支创建热修复分支:
git checkout -b hotfix/issue - 修复、测试、提交
- 合并到主分支以及开发分支(如果存在)
- 为发布打标签
每日同步:
git fetch --all --prune
git rebase origin/main # 如果团队偏好合并,也可使用 merge
提交信息
- 使用约定式提交格式:
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 前,将功能分支变基到最新的主分支
- 推送前使用
git rebase -i压缩杂乱的提交
安全清单
在执行破坏性操作(reset --hard、rebase、force push)之前:
- 这是共享分支吗? → 不要重写历史
- 我有没有未提交的更改? → 先 stash 或提交
- 我在正确的分支上吗? → 使用
git branch确认 - 远程分支是最新的吗? → 先执行
git fetch
常见陷阱
- git user.email 错误 — 在重要提交前使用
git config user.email检查 - 空目录 — Git 不跟踪它们,请添加
.gitkeep - 子模块 — 始终使用
--recurse-submodules克隆 - 分离的 HEAD — 使用
git switch -返回上一个分支 - 推送被拒绝 — 通常需要先执行
git pull --rebase - stash pop 冲突 — Stash 会消失。请改用
stash apply - 大文件 — 对于超过 50MB 的文件使用 Git LFS,切勿提交机密
- 大小写敏感 — Mac/Windows 忽略大小写,Linux 不忽略——可能引发 CI 失败
恢复命令
- 撤销上次提交但保留更改:
git reset --soft HEAD~1 - 丢弃未暂存的更改:
git restore filename - 查找丢失的提交:
git reflog(保留约 90 天的历史) - 恢复已删除的分支:
git checkout -b branch-name <sha-from-reflog> - 当提交混合了多个改动时,使用
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 # 待处理的 stash
关联技能
如果用户确认,可使用 clawhub install <slug> 安装:
gitlab— GitLab CI/CD 和合并请求docker— 容器化工作流code— 代码质量和最佳实践
反馈
- 如果您觉得有用:
clawhub star git - 保持更新:
clawhub sync