github

GitHub 模式

工具

所有 GitHub 操作都使用 gh CLI。優先使用 CLI 而非 GitHub MCP 伺服器，以減少上下文使用量。

快速指令

# 從目前分支建立 PR
gh pr create --title "feat: add feature" --body "Description"

# Squash-merge 一個 PR
gh pr merge <PR_NUMBER> --squash --title "feat: add feature (#<PR_NUMBER>)"

# 檢視 PR 狀態與檢查
gh pr status
gh pr checks <PR_NUMBER>

堆疊 PR 工作流程摘要

當合併一串堆疊 PR（每個 PR 目標為前一個分支）時：

1. 合併第一個 PR 到 main 分支（使用 squash merge）
2. 對於後續每個 PR：rebase 到 main，更新 base 為 main，然後 squash merge
3. 遇到衝突時：停止並請使用者手動解決

# 將下一個 PR 的分支 rebase 到 main，排除已合併的提交
git rebase --onto origin/main <old-base-branch> <next-branch>
git push --force-with-lease origin <next-branch>
gh pr edit <N> --base main
gh pr merge <N> --squash --title "<PR title> (#N)"

完整步驟請參閱 stacked-pr-workflow.md。

快速參考

檔案	說明
stacked-pr-workflow.md	將堆疊 PR 以個別 squash 提交合併到 main

問題 -> 技能對應

問題	從此開始
乾淨地合併堆疊 PR	stacked-pr-workflow.md