---
name: yangge521/git-workflow
source: https://app.decimal.ai/s/yangge521-git-workflow@1/SKILL.md
source_sha256: c00e787b675c
---

# Git 工作流规范

## 概述

提供 Git 工作流规范，包含分支策略、提交信息规范、合并流程、版本管理，确保团队协作高效有序。

## 使用场景

- 团队协作：多人协作开发规范
- 版本管理：项目版本发布管理
- 功能开发：功能分支开发流程
- 热修复：线上紧急修复流程
- 开源项目：开源项目贡献流程
- GPU 项目：推理/训练项目管理

## 分支策略（Git Flow 简化版）

| 分支 | 用途 | 命名规范 | 合并目标 |
|------|------|---------|---------|
| main | 生产环境 | main | - |
| develop | 开发集成 | develop | main |
| feature/* | 功能开发 | feature/yolo-optimize | develop |
| hotfix/* | 紧急修复 | hotfix/gpu-crash | main + develop |

## 提交信息规范（Conventional Commits）

格式：type(scope): subject

type: feat/fix/docs/style/refactor/perf/test/chore
scope: 影响范围（可选）
subject: 简短描述（中文）

示例：feat(ai-engineering): 优化 S4000 多路并发推理性能

## 常见问题与排查

| 问题 | 原因 | 解决方案 |
|------|------|---------|
| 提交信息混乱 | 无规范约束 | 使用 commitlint 检查 |
| 分支冲突频繁 | 长期不合并 | 缩短分支生命周期 |
| 代码回滚困难 | 合并方式不当 | 使用 --no-ff 合并 |
| 版本号混乱 | 无版本管理 | 使用语义化版本 |
| 大文件提交 | 未用 .gitignore | 配置 .gitignore |

## 扩展方向

- **Trunk-Based**: 替代 Git Flow 的轻量工作流
- **Monorepo**: 单仓库多项目管理
- **Git Hooks**: pre-commit 自动检查
- **自动版本**: semantic-release 自动版本管理
- **代码所有者**: CODEOWNERS 自动分配审查
- **Git LFS**: 大文件/模型文件管理

## 技能链路

- **pr-template-cn**: PR 遵循 Git 工作流
- **code-review-cn**: 合并前代码审查
- **ci-cd-cn**: Git 触发 CI/CD 流水线
- **code-comment-cn**: 提交前检查注释规范

## 检查清单

- [ ] 分支命名符合规范
- [ ] 提交信息遵循 Conventional Commits
- [ ] 合并前已通过代码审查
- [ ] .gitignore 配置正确
- [ ] 敏感信息未提交