diff options
| author | sillylaird <sillyfanboy@gmail.com> | 2026-09-03 00:33:59 +0000 |
|---|---|---|
| committer | sillylaird <sillyfanboy@gmail.com> | 2026-09-03 00:33:59 +0000 |
| commit | 898b52edcb47bcb3e9d6106e74ca73e74ea01e70 (patch) | |
| tree | 85c6ee5ad58b860144551184d4cf86b560c62b91 /.agents/skills/git-workflow/references/branching-strategies.md | |
| download | www-898b52edcb47bcb3e9d6106e74ca73e74ea01e70.tar.gz www-898b52edcb47bcb3e9d6106e74ca73e74ea01e70.zip | |
Diffstat (limited to '.agents/skills/git-workflow/references/branching-strategies.md')
| -rw-r--r-- | .agents/skills/git-workflow/references/branching-strategies.md | 175 |
1 files changed, 175 insertions, 0 deletions
diff --git a/.agents/skills/git-workflow/references/branching-strategies.md b/.agents/skills/git-workflow/references/branching-strategies.md new file mode 100644 index 0000000..570cf1d --- /dev/null +++ b/.agents/skills/git-workflow/references/branching-strategies.md @@ -0,0 +1,175 @@ +# 分支管理策略详解
+
+## 分支类型
+
+| 分支类型 | 命名规范 | 说明 | 生命周期 |
+| :------- | :---------------- | :------------------------- | :------------- |
+| master | `master` | 主分支，始终保持可发布状态 | 永久 |
+| develop | `develop` | 开发分支，集成最新开发代码 | 永久 |
+| feature | `feature/功能名` | 功能分支 | 开发完成后删除 |
+| bugfix | `bugfix/问题描述` | Bug修复分支 | 修复完成后删除 |
+| hotfix | `hotfix/问题描述` | 紧急修复分支 | 修复完成后删除 |
+| release | `release/版本号` | 发布分支 | 发布完成后删除 |
+
+## 分支命名规范
+
+### 功能分支
+
+```
+feature/user-management # ✅ 用户管理功能
+feature/123-add-export # ✅ 关联Issue的功能
+```
+
+### Bug修复分支
+
+```
+bugfix/login-error # ✅ 登录错误修复
+bugfix/456-fix-timeout # ✅ 关联Issue的修复
+```
+
+### 紧急修复分支
+
+```
+hotfix/security-vulnerability # ✅ 安全漏洞修复
+hotfix/v1.0.1 # ✅ 版本号修复
+```
+
+### 发布分支
+
+```
+release/v1.0.0 # ✅ 版本发布
+release/v2.0.0-beta.1 # ✅ 预发布版本
+```
+
+## 分支保护规则
+
+### master 分支
+
+- 禁止直接推送
+- 必须通过 Pull Request 合并
+- 必须通过 CI 检查
+- 必须至少一人 Code Review
+
+### develop 分支
+
+- 限制直接推送
+- 建议通过 Pull Request 合并
+- 必须通过 CI 检查
+
+## 分支操作命令
+
+### 创建功能分支
+
+```bash
+git checkout develop
+git pull origin develop
+git checkout -b feature/user-management
+```
+
+### 创建Bug修复分支
+
+```bash
+git checkout develop
+git pull origin develop
+git checkout -b bugfix/login-error
+```
+
+### 创建紧急修复分支（从master创建）
+
+```bash
+git checkout master
+git pull origin master
+git checkout -b hotfix/security-fix
+```
+
+### 删除分支
+
+```bash
+git branch -d feature/user-management # 删除本地分支
+git push origin -d feature/user-management # 删除远程分支
+```
+
+## 工作流程详解
+
+### 日常开发流程
+
+```bash
+# 1. 同步最新代码
+git checkout develop
+git pull origin develop
+
+# 2. 创建功能分支
+git checkout -b feature/user-management
+
+# 3. 开发并提交
+git add .
+git commit -m "feat(user): 添加用户列表页面"
+
+# 4. 推送到远程
+git push -u origin feature/user-management
+
+# 5. 创建 Pull Request 并请求 Code Review
+
+# 6. 合并到 develop（通过 PR）
+
+# 7. 删除功能分支
+git branch -d feature/user-management
+git push origin -d feature/user-management
+```
+
+### 紧急修复流程
+
+```bash
+# 1. 从 master 创建修复分支
+git checkout master
+git pull origin master
+git checkout -b hotfix/critical-bug
+
+# 2. 修复并提交
+git add .
+git commit -m "fix(auth): 修复认证绕过漏洞"
+
+# 3. 合并到 master
+git checkout master
+git merge --no-ff hotfix/critical-bug
+git tag -a v1.0.1 -m "hotfix: 修复认证绕过漏洞"
+git push origin master --tags
+
+# 4. 同步到 develop
+git checkout develop
+git merge --no-ff hotfix/critical-bug
+git push origin develop
+
+# 5. 删除修复分支
+git branch -d hotfix/critical-bug
+```
+
+### 版本发布流程
+
+```bash
+# 1. 创建发布分支
+git checkout develop
+git checkout -b release/v1.0.0
+
+# 2. 更新版本号和文档
+# 修改 package.json 版本号
+# 更新 CHANGELOG.md
+
+# 3. 提交版本更新
+git add .
+git commit -m "chore(release): 准备发布 v1.0.0"
+
+# 4. 合并到 master
+git checkout master
+git merge --no-ff release/v1.0.0
+git tag -a v1.0.0 -m "release: v1.0.0 正式版本"
+git push origin master --tags
+
+# 5. 同步到 develop
+git checkout develop
+git merge --no-ff release/v1.0.0
+git push origin develop
+
+# 6. 删除发布分支
+git branch -d release/v1.0.0
+```
|