git-workflow-guide

# Git 工作流程指南 > **語言**: [English](../../../../skills/git-workflow-guide/SKILL.md) | 繁體中文 **版本**: 1.0.0 **最後更新**: 2025-12-24 **適用範圍**: Claude Code Skills --- ## 目的 本技能提供 Git 分支策略、分支命名慣例與合併操作的指導。 ## 快速參考 ### 工作流程策略選擇 | 部署頻率 | 建議策略 | |---------|---------| | 每日多次 | Trunk-Based Development | | 每週至雙週 | GitHub Flow | | 每月或更長 | GitFlow | ### 分支命名慣例 ``` <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. **描述性但簡潔** ## 詳細指南 完整標準請參閱： - [Git 工作流程策略](./git-workflow.md) - [分支命名參考](./branch-naming.md) ## 建立分支前檢查清單 建立新分支前： 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 + FF** | Trunk-Based、短期分支 | ## 範例 ### 建立功能分支 ```bash # 良好範例 git checkout -b feature/user-authentication git ...