完成開發分支

概述

通過提供清晰的選項和處理選定的工作流程來指導開發工作的完成。

核心原則： 驗證測試→呈現選項→執行選擇→清理。

開始時宣佈：“我正在使用完成開發分支技能來完成這項工作。”

流程

第 1 步：驗證測試

在提供選項之前，請先驗證測試是否通過：

Run project's test suite

npm test / cargo test / pytest / go test ./...

如果測試失敗：

Tests failing (<N> failures). Must fix before completing:

[Show failures]

Cannot proceed with merge/PR until tests pass.

停止。不要繼續執行步驟 2。

如果測試通過： 繼續執行步驟 2。

步驟2：確定基礎分支

Try common base branches

git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null

或者問：“這個分支從主分支中分離出來 - 這是正確的嗎？”

第 3 步：提出選項

準確呈現這 4 個選項：

Implementation complete. What would you like to do?

1. Merge back to <base-branch> locally
2. Push and create a Pull Request
3. Keep the branch as-is (I'll handle it later)
4. Discard this work

Which option?

不要加入解釋 - 保持選項簡潔。

第四步：執行選擇

選項 1：本地合併

Switch to base branch

git checkout <base-branch>

Pull latest

git pull

Merge feature branch

git merge <feature-branch>

Verify tests on merged result

<test command>

If tests pass

git branch -d <feature-branch>

然後：清理工作樹（步驟 5）

選項2：全民並建立PR

Push branch

git push -u origin <feature-branch>

Create PR

gh pr create --title "<title>" --body "$(cat <<'EOF'

Summary

<2-3 bullets of what changed>

Test Plan

• <verification steps> EOF )"

然後：清理工作樹（步驟 5）

選項 3：保持原樣

報告：“保留分支 <名稱>。工作樹保留在 <路徑>。”

**不要清理工作樹。 **

選項 4：丟棄

先確認：

This will permanently delete:

• Branch <name>
• All commits: <commit-list>
• Worktree at <path>

Type 'discard' to confirm.

等待具體確認。

如果確認：

git checkout <base-branch> git branch -D <feature-branch>

然後：清理工作樹（步驟 5）

第 5 步：清理工作樹

對於選項 1、2、4：

檢查是否在工作樹中：

git worktree list | grep $(git branch --show-current)

如果是：

git worktree remove <worktree-path>

對於選項 3： 保留工作樹。

快速參考

選項 合併 推 保留工作樹 清理分行

1.本地合併 ✓

✓

2.建立公關

✓ ✓

3. 保持原樣

✓

4. 丟棄

✓（力）

常見錯誤

跳過測試驗證

• **問題：**合併損壞的碼，建立失敗的PR

• 修復： 在提供選項之前始終驗證測試

開放式問題

• 問題：“接下來我應該做什麼？” → 模棱兩可

• 修復： 準確呈現 4 個結構化選項

自動工作樹清理

• 問題： 在可能需要時刪除工作樹（選項 2、3）

• 修復： 僅清理選項 1 和 4

沒有確認丟棄

• 問題： 意外刪除工作

• 修復： 需要輸入「丟棄」確認

危險信號

絕不：

• 繼續失敗的測試

• 合併而不驗證結果測試

• 刪除作品而不確認

• 沒有明確請求的強制推送

總是：

• 在提供選項之前驗證測試

• 正好給出 4 個選項

• 取得選項 4 的鍵入確認訊息

• 僅清理選項 1 和 4 的工作樹

一體化

調用者：

• 子代理驅動開發（第 7 步）- 所有任務完成後

• 執行計劃（步驟 5）- 所有批次完成後

搭配：

• using-git-worktrees - 透過此技能創建工作樹進行清理