/git

name: git
description: "Git version control best practices: branching, commits, merging, conflict resolution, PR workflows. Use when managing branches, creating commits, merging code, or resolving conflicts."
allowed-tools: Read, Write, Edit, Bash, Grep, Glob

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](commands-reference.md) | 常用 Git 命令参考 | | [pr-workflow.md](pr-workflow.md) | Pull Request 流程 | | [hooks-guide.md](hooks-guide.md) | Git Hooks 指南 | | [delegation.md](delegation.md) | 委派到专业 Agent |

---

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