git-workflow-guide
引導 Git 分支策略、分支命名與合併操作。 Use when: 建立分支、合併、pull request、Git 工作流程相關問題。 Not for: 撰寫 commit message——請用 /commit；推送前的安全檢查——請用 /push。 Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程, 分支命名.
소스 정보
- 저장소
- AsiaOstrich/universal-dev-standards
- 최근 소스 활동
- 2026년 8월 20일 06:47
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 75
- 포크
- 13
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
3 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- source
- ../../../../skills/git-workflow-guide/SKILL.md
- source_version
- 1.0.0
- translation_version
- 1.1.0
- last_synced
- 2026-08-17T00:00:00.000Z
- status
- current
- name
- git-workflow-guide
- description
- 引導 Git 分支策略、分支命名與合併操作。 Use when: 建立分支、合併、pull request、Git 工作流程相關問題。 Not for: 撰寫 commit message——請用 /commit；推送前的安全檢查——請用 /push。 Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程, 分支命名.
- scope
- universal
# 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 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]**
```
---
## 相關標準
- [Git 工作流程](../../core/git-workflow.md)
- [提交訊息指南](../../core/commit-message-guide.md)
- [簽入標準](../../core/checkin-standards.md)
---
## 版本歷史
| 版本 | 日期 | 變更 |
|------|------|------|
| 1.0.0 | 2025-12-24 | 新增：標準章節（目的、相關標準、版本歷史、授權） |
---
## 授權
本技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
**來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
## Next Steps Guidance | 下一步引導
After `/git-flow` completes, the AI assistant should suggest:
> **Git 工作流程已設定。建議下一步 / Git workflow configured. Suggested next steps:**
> - 執行 `git checkout -b feature/<描述>` 建立功能分支開始開發 ⭐ **Recommended / 推薦** — 立即套用所選的分支策略 / Apply the chosen branching strategy immediately
> - 執行 `/commit` 學習提交訊息規範 — 確保提交訊息格式一致 / Ensure consistent commit message format
> - 執行 `/checkin` 了解簽入品質門檻 — 在提交前確保程式碼品質 / Ensure code quality before commits
---
## Related Standards
- [Git Workflow](../../core/git-workflow.md) - Core Git workflow standard
- [Commit Message Guide](../../core/commit-message-guide.md) - Commit message conventions
- [Checkin Standards](../../core/checkin-standards.md) - Pre-commit quality gates
---
## Version History
| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2025-12-24 | Added: Standard sections (Purpose, Related Standards, Version History, License) |
---
## License
This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
GitHub에서 보기