學習 GitHub 團隊協作標準流程：分支命名規範、9 步驟 PR 循環、Squash Merge 策略、分支保護規則與 Codex Agent 自動化整合，適合 Full Agentic 團隊快速上手。
GitHub 協作核心概念
GitHub 團隊協作的基礎邏輯只有一條：所有人在各自的分支開發，完成後透過 Pull Request（PR）請求審查，通過才合併回 main 主分支。這個機制確保多人同時開發時不會互相覆蓋程式碼，並保留完整的修改歷史。
把 repo 想像成一本共享筆記本，main 是正式版本。若兩人直接在 main 改同一檔案，後存者會覆蓋先存者。分支就像「影印一份筆記本」，讓每人在副本上安心修改，完成後用 PR 說：「我改好了，請檢查並合併回正式版」。
標準 9 步驟協作循環
適合搭配 Codex Agent 自動化執行的標準流程：
| 步驟 | 指令 / 動作 | 說明 |
|---|---|---|
| 1 | git pull origin main |
先拉取最新 main，確保從最新版本開始 |
| 2 | git checkout -b feature/功能名稱 |
建立並切換新分支（如 feature/login） |
| 3 | 開發與提交 | Agent 在分支修改程式碼，執行 git commit -m "描述" |
| 4 | git push origin feature/功能名稱 |
推送分支到 GitHub |
| 5 | 在 GitHub 建立 PR | 點選「Compare & pull request」，填寫標題與說明 |
| 6 | 同事審查 | 在 PR 頁面查看異動、留言提問或要求修改 |
| 7 | 解決衝突（如有） | 若 main 有更新，先 git pull 再手動解決衝突 |
| 8 | 合併 PR | 審查通過後點選「Merge pull request」合併回 main |
| 9 | 刪除分支 | 合併後刪除已完成分支，保持 repo 整潔 |
實戰情境：兩位開發者平行開發
開發者 A：登入功能
# 1. 拉下最新 main
git pull origin main
# 2. 建立分支
git checkout -b feature/login
# 3-4. 開發、提交、推送
git add .
git commit -m "Add login form"
git push origin feature/login
# 5. 建立 PR：feature/login → main
# 6. 開發者 B 審查
# 7-8. 通過合併
# 9. 刪除分支
git branch -d feature/login
開發者 B：購物車功能（同步進行）
git pull origin main
git checkout -b feature/cart
git add .
git commit -m "Add shopping cart"
git push origin feature/cart
# 建立 PR → 開發者 A 審查 → 合併 → 刪除分支
兩分支獨立開發互不干擾。合併時 GitHub 自動檢查衝突，有衝突會提示需手動解決。
Full Agentic 團隊最佳實踐
分支命名規範
統一命名讓 Agent 更易識別與自動化：
feature/功能名稱：新功能開發fix/問題描述：Bug 修復hotfix/緊急修復：生產環境緊急修復
PR 審查重點
- 異動檔案檢查：確認只改相關檔案
- 測試通過：CI/CD 自動化測試全部綠燈
- 程式碼品質：遵循團隊風格指南與最佳實踐
- 留言全數解決：審查者提問皆已回覆
合併策略：建議 Squash Merge
- 將分支多個 commit 壓縮為單一 commit 合併進
main - 保持主分支提交紀錄乾淨
- 適合功能導向開發流程
分支保護規則（必啟用）
在 GitHub Repo Settings → Branches 中設定：
- 禁止直接 push 到
main - 要求至少 1 人審查通過才能合併
- 要求 CI 測試通過才能合併
常見問題解答
Q: 什麼是 Merge Conflict？
當兩人修改同一檔案同一行程式碼，Git 無法自動決定保留哪版，產生衝突。
解決步驟：
- 本地執行
git pull origin main拉取最新變更 - 用編輯器（如 VS Code）手動選擇保留的程式碼
- 提交解決結果：
git add .→git commit -m "Resolve merge conflict" - 再次 push，PR 自動更新
Q: 可用 GitHub Desktop 或 VS Code 操作嗎？
可。這些 GUI 工具本質執行相同 Git 指令，對初學者更友善。
Q: Codex Agent 如何自動化此流程？
設計 Agent 工作流：
- 偵測新功能需求 → 自動建立分支
- 開發完成 → 自動 commit 與 push
- 呼叫 GitHub API 建立 PR
- 通知同事審查（Slack、Email 等）
- 審查通過 → 自動合併並刪除分支
結語
這套流程是現代軟體開發的標準做法。熟練後能大幅降低協作衝突，讓程式碼審查成為團隊的品質把關機制。對 Full Agentic 團隊而言，將上述步驟封裝為自動化工作流，更能釋放開發產能，專注於核心業務邏輯。