AgentSkillsCN

git-flow

指导 Git 分支策略、分支命名与合并操作。 使用时机：创建分支、合并、Pull Request、解决 Git 工作流程中的问题。 关键词：branch、merge、PR、pull request、GitFlow、GitHub Flow、分支、合并、工作流程。

SKILL.md
--- frontmatter
source: /skills/git-workflow-guide/SKILL.md
source_version: 1.0.0
translation_version: 1.0.0
last_synced: 2025-12-25
status: current
name: git-flow
description: |
  指導 Git 分支策略、分支命名與合併操作。
  使用時機：建立分支、合併、Pull Request、Git 工作流程問題。
  關鍵字：branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程。

Git 工作流程指南

語言: English | 繁體中文

版本: 1.0.0 最後更新: 2025-12-24 適用範圍: Claude Code Skills

目的

本技能提供 Git 分支策略、分支命名慣例與合併操作的指導。

快速參考

工作流程策略選擇

部署頻率建議策略
每日多次Trunk-Based Development
每週至雙週GitHub Flow
每月或更長GitFlow

分支命名慣例

code
<type>/<short-description>
類型用途範例
feature/新功能feature/oauth-login
fix/ 或 bugfix/錯誤修復fix/memory-leak
hotfix/緊急生產環境修復hotfix/security-patch
refactor/程式碼重構refactor/extract-service
docs/僅文件變更docs/api-reference
test/測試新增test/integration-tests
chore/維護任務chore/update-dependencies
release/發布準備release/v1.2.0

命名規則

  1. •使用小寫
  2. •使用連字號分隔單字
  3. •描述性但簡潔

詳細指南

完整標準請參閱：

建立分支前檢查清單

建立新分支前：

  1. •

    檢查未合併的分支

    bash
    git branch --no-merged main
  2. •

    同步最新程式碼

    bash
    git checkout main
git pull origin main
  3. •

    驗證測試通過

    bash
    npm test  # 或您專案的測試指令
  4. •

    使用正確命名建立分支

    bash
    git checkout -b feature/description

合併策略快速指南

策略使用時機
Merge Commit (--no-ff)長期功能、GitFlow 發布
Squash Merge功能分支、乾淨歷史
Rebase + FFTrunk-Based、短期分支

範例

建立功能分支

bash
# 良好範例
git checkout -b feature/user-authentication
git checkout -b fix/null-pointer-in-payment
git checkout -b hotfix/critical-data-loss

# 不良範例
git checkout -b 123              # 缺乏描述性
git checkout -b Fix-Bug          # 非小寫
git checkout -b myFeature        # 缺少類型前綴

合併工作流程 (GitHub Flow)

bash
# 1. 從 main 建立分支
git checkout main
git pull origin main
git checkout -b feature/user-profile

# 2. 進行變更並提交
git add .
git commit -m "feat(profile): add avatar upload"
git push -u origin feature/user-profile

# 3. 透過 GitHub/GitLab UI 建立 PR 並合併

# 4. 合併後刪除分支
git checkout main
git pull origin main
git branch -d feature/user-profile

處理合併衝突

bash
# 1. 使用 main 更新您的分支
git checkout feature/my-feature
git fetch origin
git merge origin/main

# 2. 在檔案中解決衝突
# <<<<<<< HEAD
# 您的變更
# =======
# 傳入的變更
# >>>>>>> origin/main

# 3. 暫存已解決的檔案
git add resolved-file.js

# 4. 完成合併
git commit -m "chore: resolve merge conflicts with main"

# 5. 測試並推送
npm test
git push origin feature/my-feature

組態偵測

本技能支援專案特定的工作流程組態。

偵測順序

  1. •檢查 CONTRIBUTING.md 是否有「Git Workflow」或「Branching Strategy」章節
  2. •若找到，使用指定的策略（GitFlow / GitHub Flow / Trunk-Based）
  3. •若未找到，預設使用 GitHub Flow 以保持簡單

首次設定

若未找到組態：

  1. •詢問使用者：「本專案尚未設定 Git 工作流程策略。您偏好哪一種？（GitFlow / GitHub Flow / Trunk-Based）」
  2. •選擇後，建議在 CONTRIBUTING.md 中記錄：
markdown
## Git 工作流程

### 分支策略
本專案使用 **[所選選項]**。

### 分支命名
格式：`<type>/<description>`
範例：`feature/oauth-login`、`fix/memory-leak`

### 合併策略
- 功能分支：**[Squash / Merge commit / Rebase]**

相關標準

版本歷史

版本日期變更
1.0.02025-12-24新增：標準章節（目的、相關標準、版本歷史、授權）

授權

本技能採用 CC BY 4.0 授權發布。

來源：universal-dev-standards