finishing-a-development-branch 是什麼、怎麼用：Superpowers 開發收尾 Skill（驗證測試後選擇合併、開 PR 或保留）

本文根據 obra/superpowers 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 20.3 萬次；所在倉庫 obra/superpowers 在 GitHub 約 29.7 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

功能做完之後的那幾步——跑測試、合併、開 PR、刪分支——瑣碎但容易出錯：合到了錯誤的分支，或者工作區沒清理留下一堆殘餘。finishing-a-development-branch 把收尾固定成一個流程。description：實現已完成、所有測試通過、需要決定如何整合這些工作時使用。總綱是五個動作：驗證測試 → 檢測環境 → 給出選項 → 執行選擇 → 清理。

第一步是跑項目的完整測試；失敗就報告並停下，選項選單只在全綠之後出現。第二步檢測當前是普通倉庫還是 worktree，這決定了展示哪種選單以及之後怎麼清理。第三步確定基線分支，並在合併前向你確認——說明裏的理由是，合進錯誤的基線，撤銷起來代價很高。

然後給出選項：在本地合併、推送並創建 PR、保持現狀稍後處理。丟棄工作不在預設選單裏，只有你主動提出時才會走那條路，而且要求你輸入確認詞才執行。最後按所處環境清理工作區。和其他 Superpowers 技能一樣，文末附了一張常見藉口表，例如「測試大概沒問題，直接合吧」。

怎麼安裝

finishing-a-development-branch 是 Superpowers 插件裏的一個技能，不單獨發佈：作者的設計是整套一起安裝，由會話開始時注入的引導指令決定各技能何時觸發。Claude Code 裏輸入（命令來自倉庫 README）：

text
/plugin install superpowers@claude-plugins-official

Codex 在 /plugins 裏搜尋 superpowers 安裝；Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers。裝好後在命令選單裏以 /superpowers:finishing-a-development-branch 的形式出現，也會按場景自動觸發。

倉庫整體介紹和其他安裝方式，詳見本站《Superpowers 是什麼、怎麼安裝和使用：Claude Code / Codex 最熱門的 Skills 開發流程框架》。

怎麼用

• 計劃裏的任務全部完成後會自動觸發，並先聲明正在用這個技能收尾。
• 手動：「這個分支做完了，幫我收尾」——它會先跑測試，再問你選哪種整合方式。
• 選擇創建 PR 時，它會推送分支，再用託管平台的命令行工具（沒有就用推送後打印出的創建連結）開 PR，遵循倉庫已有的 PR 模板，並把連結報告給你；worktree 會保留，方便繼續處理評審意見。

這個技能只有一份 SKILL.md。

適合誰 / 侷限

適合用分支或 worktree 做功能開發、希望收尾動作規範一致的人。團隊有自己的合併策略（必須走 PR、受保護分支等）時，要把規則告訴它；創建 PR 最順暢的前提是本機已登入託管平台的命令行工具。

注意事項

• 許可：MIT。
• 會執行合併、推送、刪除 worktree 等 git 操作，其中合併與丟棄都設計了確認環節，注意看清它確認的基線分支。
• 它不會替你做發佈：合併之後的部署、打標籤不在範圍內。