| 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 版本控制的最佳实践。
触发条件
当用户提及以下关键词时自动激活：git, commit, branch, merge, rebase, cherry-pick, PR, pull request, conflict, stash, gitflow, conventional commits
常见场景：
- 管理 Git 分支
- 创建提交
- 处理合并
- 解决冲突
- 代码审查
Workflow | 工作流程
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 → 推送 |
| 解决冲突 | 查看冲突 → 手动解决 → 标记解决 → 继续 |
| 创建 PR | 推送分支 → gh pr create → 等待审查 |
3. 执行并验证
- 执行命令前确认当前分支和状态
- 执行后验证结果：
git status, git log --oneline -3
- 确保无未提交的修改或冲突
4. 完成确认
✅ Git 操作完成！
📊 当前状态:
分支: [当前分支名]
最新提交: [commit message]
⚠️ 提醒:
- 功能完成后记得创建 PR
- 合并前确保通过所有测试
- 定期从 main 分支同步更新
分支策略
Git Flow
main (生产)
│
└── develop (开发)
│
├── feature/xxx (功能分支)
├── release/x.x (发布分支)
└── hotfix/xxx (热修复)
GitHub Flow（推荐）
main (始终可部署)
│
└── feature/xxx (功能分支)
│
└── PR → Code Review → Merge
分支命名规范
feature/add-user-auth
feature/JIRA-123-payment-integration
fix/login-validation
bugfix/JIRA-456-cart-total
hotfix/security-patch
release/v1.2.0
refactor/database-layer
提交规范 (Conventional Commits)
格式
<type>(<scope>): <subject>
<body>
<footer>
类型
| 类型 | 说明 | 示例 |
|---|
| feat | 新功能 | feat(auth): 添加 OAuth 登录 |
| fix | Bug 修复 | fix(cart): 修复价格计算错误 |
| docs | 文档更新 | docs(readme): 更新安装说明 |
| style | 格式调整 | style: 格式化代码 |
| refactor | 重构 | refactor(api): 重构用户服务 |
| perf | 性能优化 | perf(query): 优化搜索查询 |
| test | 测试 | test(user): 添加用户注册测试 |
| chore | 构建/工具 | chore(deps): 更新依赖 |
| ci | CI 配置 | ci: 添加 GitHub Actions |
示例
git commit -m "feat(user): 添加用户头像上传功能"
git commit -m "fix(payment): 修复支付金额精度问题
- 使用 Decimal 替代 float 处理金额
- 添加金额格式化工具函数
- 更新相关测试用例
Closes #123"
git commit -m "feat(api)!: 重构 API 响应格式
BREAKING CHANGE: API 响应格式从 {data} 改为 {success, data, error}"
常用命令
详细内容参见 commands-reference.md
合并策略
Merge（合并提交）
git checkout main
git merge feature/xxx
Rebase（变基）
git checkout feature/xxx
git rebase main
Squash Merge（压缩合并）
git checkout main
git merge --squash feature/xxx
git commit -m "feat: 完成用户功能"
选择策略
| 场景 | 推荐策略 |
|---|
| 功能分支 → main | Squash Merge |
| main → 功能分支 | Rebase |
| 长期分支同步 | Merge |
| 发布分支 | Merge |
冲突解决
解决步骤
git fetch origin
git rebase origin/main
git status
git add resolved-file.ts
git rebase --continue
git rebase --abort
冲突标记
<<<<<<< HEAD
当前分支的代码
=======
合并分支的代码
>>>>>>> feature/xxx
VS Code 冲突解决
- Accept Current Change (保留当前)
- Accept Incoming Change (保留传入)
- Accept Both Changes (保留两者)
- Compare Changes (比较差异)
Pull Request 流程
详细内容参见 pr-workflow.md
Git Hooks
详细内容参见 hooks-guide.md
.gitignore 最佳实践
# 依赖
node_modules/
venv/
__pycache__/
# 构建输出
dist/
build/
*.egg-info/
# 环境变量
.env
.env.local
.env.*.local
# IDE
.idea/
.vscode/
*.swp
# OS
.DS_Store
Thumbs.db
# 日志
*.log
logs/
# 测试覆盖率
coverage/
.coverage
# 缓存
.cache/
.pytest_cache/
最佳实践
- 小而频繁的提交 - 每个提交做一件事
- 有意义的提交信息 - 说明为什么，不只是什么
- 保持分支更新 - 经常从主分支同步
- PR 前自检 - lint、test、review
- 不要提交敏感信息 - 使用环境变量
- 使用 .gitignore - 忽略不需要的文件
- 定期清理分支 - 合并后删除
- 备份重要操作 - 变基前创建备份分支
- 团队约定 - 统一的分支和提交规范
- 利用 Git Hooks - 自动化检查
快速场景指南 | Quick Scenarios
日常开发
git checkout main && git pull
git checkout -b feature/my-feature
git add -A && git commit -m "feat: add new feature"
git push -u origin feature/my-feature
gh pr create --fill
紧急修复
git checkout main && git pull
git checkout -b hotfix/critical-fix
git add -A && git commit -m "fix: critical bug"
git checkout main && git merge hotfix/critical-fix
git push origin main
冲突解决
git fetch origin
git rebase origin/main
git add <resolved-files>
git rebase --continue
委派到专业 Agent | Delegation to Agents
详细内容参见 delegation.md
记住: Git 是协作的基石——清晰的分支策略和提交规范让团队协作事半功倍。
