Git 工作流技能

本技能提供 Git 版本控制的最佳实践。

快速参考

• 推荐分支模型: GitHub Flow（main + feature 分支 + PR）
• 提交规范: Conventional Commits（<type>(<scope>): <subject>）
• 合并策略: 功能分支 → Squash Merge，同步主分支 → Rebase，长期分支 → Merge

触发条件

git, commit, branch, merge, rebase, PR, pull request, conflict, stash

工作流程

1. 检查状态: git status && git branch -a && git log --oneline -5
2. 选择操作:

场景	执行流程
创建功能分支	git checkout -b feature/xxx → 开发 → 提交
提交代码	git add → git commit → 验证
合并代码	git checkout main → git merge → 推送
解决冲突	查看冲突 → 手动解决 → git add → git rebase --continue
创建 PR	推送分支 → gh pr create → 等待审查

3. 执行后验证: git status, git log --oneline -3

分支命名规范

feature/add-user-auth     # 功能分支
fix/login-validation      # Bug 修复
hotfix/security-patch     # 热修复
release/v1.2.0            # 发布
refactor/database-layer   # 重构

提交类型

类型	说明	示例
feat	新功能	feat(auth): 添加 OAuth 登录
fix	Bug 修复	fix(cart): 修复价格计算错误
docs	文档更新	docs(readme): 更新安装说明
refactor	重构	refactor(api): 重构用户服务
test	测试	test(user): 添加注册测试
chore	构建/工具	chore(deps): 更新依赖
perf	性能优化	perf(query): 优化搜索查询

合并策略选择

场景	推荐策略
功能分支 → main	Squash Merge
main → 功能分支	Rebase
长期分支同步	Merge

最佳实践

1. 小而频繁的提交，每个做一件事
2. 有意义的提交信息，说明为什么
3. 经常从主分支同步
4. PR 前自检（lint、test、review）
5. 不提交敏感信息
6. 合并后删除功能分支

子文件索引

文件	内容
commands-reference.md	常用 Git 命令参考
pr-workflow.md	Pull Request 流程
hooks-guide.md	Git Hooks 指南
delegation.md	委派到专业 Agent

---

记住: Git 是协作的基石——清晰的分支策略和提交规范让团队协作事半功倍。