finishing-a-development-branch

finishing-a-development-branch 技能為 Git 工作流程中的軟體工程任務提供了標準化且可靠的結束協議。它是開發生命週期中的最後一道守門員，確保程式碼不僅在功能上完整，且已正確整合至專案的主分支中。此技能專為在強調測試嚴謹性與儲存庫整潔的協作環境中運作的軟體代理而設計。它能防止諸如合併損壞程式碼或遺留多餘功能分支等常見錯誤，為代理提供明確且具確定性的指引。

• 自動執行專案特定的測試套件（如 npm, cargo, pytest, go test），在繼續下一步前驗證實作成果。

• 使用 git merge-base 動態判斷合適的基礎分支（main 或 master）。

• 提供四種明確且無歧義的工作流程選項：本地合併、推送遠端並建立 Pull Request、保留開發中進度，或是永久捨棄變更。

• 管理複雜的清理任務，包括在功能分支被合併或刪除時移除 git 工作樹 (worktree)，避免工作空間雜亂。

• 強制執行安全檢查，例如在執行刪除分支等破壞性動作前，要求明確的人工確認。

• 此技能適用於自動化程式設計助手，應在開發任務結束或完成子代理開發計畫後觸發。

• 要求專案擁有已正確配置的測試套件，以確保開發環境的運作順暢。

• 透過標準終端輸出提供清晰的反饋，確保代理的決策過程對開發者保持透明。

• 在選擇合併、建立 PR 或清理策略時需要使用者的一致性輸入，從而促成人工驗證步驟。

• 嚴格遵守安全整合原則，若底層測試套件回報失敗，將拒絕任何合併程式碼的嘗試。