我的 Claude Code 自訂指令－並行開發工作樹

先說結論

Token 大殺器

什麼是 Worktree？

每個工作樹都是獨立的資料夾，但共用同一個 .git。你可以看下面圖片的資料夾結構就可以理解了。

工作樹的數量沒有限制，你可以一直建立新的工作樹。因為他等於複製了你的專案，會有限制的是你硬碟的大小。工作樹就是你的專案的分靈體。

獨立目錄互不影響

物理上他就是一個獨立的目錄，只是受到 Git 追蹤。所以你可以直接切到該目錄用 Claude Code 等工具開始開發，或用 IDE 開啟工作樹的目錄開始開發。我習慣分功能開工作樹，或是要寫測試時我也會獨立開工作樹。

愛到才知影痛

AI 開發有一個問題會讓人類很痛苦，就是鬼打牆。

甘特圖

從圖來看，很明顯就可以看出並行開發的效率。

工作樹指令

自從有了 AI 後，懶惰的個性被徹底開發了。什麼工作樹的 git 指令要我背，那是不可能的。因此我也讓 AI 規劃出了四個工作樹專用的指令。

其中建立工作樹的指令有一個小巧思：指令後面可以接著用簡單文字輸入你要建立這個工作樹的目的，系統會幫你用英文命名工作樹名稱和 git 分支。指令我放在文章最後面。

/worktree-done 合併工作樹指令的流程

這個流程圖說明合併工作樹執行的過程，可以感覺一下工作樹的 flow。

工作樹生命週期

我讓 AI 幫我畫整個生命週期，我覺得不明覺厲就放上來了，可以幫助你了解整個 flow。

累積經驗建立自己的工作流

工作樹概念很簡單，AI 出現後可以玩出各種花來。

注意事項

我的 Prompt

我的做法是把指令放在使用者根目錄下。

這樣在 Claude Code 打斜線就能有這樣的指令出現，美觀又直覺。

---
argument-hint: [name]
description: 建立新的 Git Worktree
---

根據提供的參數建立新的 Git Worktree 並自動設置完整的開發環境。

參數格式：`/worktree-create [name]`

- `name`: 功能描述或識別名稱（必填，AI 會根據內容自動判斷類型）

範例：

- `/worktree-create user-dashboard` → feature/user-dashboard
- `/worktree-create 使用者儀表板重設計` → feature/user-dashboard-redesign
- `/worktree-create 權限驗證修復` → hotfix/permission-validation-fix（AI 識別為修復）
- `/worktree-create 快取效能實驗` → experiment/cache-performance-experiment（AI 識別為實驗）
- `/worktree-create story-1.5-工作流程整合` → story/1.5-workflow-integration（AI 識別為 story）

執行以下流程：

1. **解析和優化參數**：

   - 分析 `$ARGUMENTS` 中的 name 參數
   - AI 根據內容自動判斷 type：
     - 包含「修復」、「fix」、「bug」→ hotfix
     - 包含「實驗」、「experiment」、「測試」→ experiment
     - 包含「story」或數字編號 → story
     - 其他情況 → feature（預設）
   - **中文名稱轉換**：將中文任務名稱轉換為符合命名規則的英文
     - 翻譯成語意清晰的英文詞彙
     - 轉換為 kebab-case 格式（小寫，用連字號分隔）
     - 避免縮寫，確保名稱具描述性
     - 遵循 Fortuna 專案的 4-6 個單字命名原則

2. **建立工作樹**：

   - 使用 `git worktree add` 建立新工作樹
   - 確保目錄和分支命名符合專案規範

3. **完成報告**：
   提供建立結果摘要，包含：
   - 原始中文輸入 → 轉換後的英文名稱
   - 工作樹路徑和分支名稱
   - 下一步指令

執行所有必要的安全檢查，確保不與現有工作樹衝突。

---
description: 合併工作樹分支並清理
---

在主目錄中執行工作樹完成流程：選擇並合併工作樹分支到 main，然後清理工作樹。

**使用場景**：當您完成工作樹開發，希望將變更合併回主分支並清理工作樹時使用。

執行以下流程：

1. **環境檢查**：

   - 確認當前位於主目錄中
   - 檢查主目錄工作狀態是否清潔
   - 驗證當前在 main 分支

2. **工作樹分支發現**：

   - 自動掃描所有現有的工作樹
   - 檢查每個工作樹分支的狀態和提交情況
   - 顯示可合併的工作樹分支清單（已有提交且工作目錄清潔）

3. **互動式分支選擇**：

   - 顯示工作樹分支清單，包含：
     - 分支名稱
     - 最新提交訊息
     - 提交時間
     - 工作樹路徑
   - 讓使用者選擇要合併的分支
   - 確認合併操作

4. **執行合併流程**：

   - 更新 main 分支：`git pull origin main`
   - 合併選定的工作樹分支到 main
   - 推送合併後的 main 分支到遠端
   - 執行品質檢查確保合併成功

5. **自動清理**：
   - 刪除已合併的工作樹目錄
   - 移除本地工作樹分支
   - 顯示清理結果

**使用範例**：

```bash
# 在主目錄執行
cd /Users/jackle/workspace/Fortuna
/WorkTree:done
```

**輸出範例**：

```
🔍 發現以下可合併的工作樹分支：

1. feature/strapi-typescript-optimization
   📂 /Users/jackle/workspace/fortuna-feature-strapi-typescript-optimization
   📝 feat(typescript): 完成 Strapi v5 TypeScript 優化與 shared 套件建置修正
   🕐 2025-07-19 23:41:23

2. feature/workflow-engine-v2
   📂 /Users/jackle/workspace/fortuna-feature-workflow-engine-v2
   📝 feat(workflow): 實作工作流程執行引擎核心功能
   🕐 2025-07-19 15:30:45

請選擇要合併的分支 (輸入數字):
```

**安全檢查**：

- 僅顯示已提交且工作目錄清潔的工作樹
- 合併前確認 main 分支是最新狀態
- 提供合併預覽和確認步驟

**注意事項**：

- 必須在主目錄中執行（非工作樹目錄）
- 確保選定的工作樹已完成所有開發工作
- 合併後工作樹將被自動清理，請確保重要變更已提交

---
argument-hint: [target]
description: 智能清理 Git Worktrees
---

智能分析並安全清理 Git Worktrees，確保不遺失重要開發成果。

參數格式：`/worktree-cleanup [target]`

- `target`: 清理目標（可選）
  - 特定工作樹名稱（如 "story-1.4", "feature-dashboard"）
  - 不指定：顯示清理建議但不執行

範例：

- `/worktree-cleanup` （僅分析和建議）
- `/worktree-cleanup story-1.4` （清理特定工作樹）

執行以下清理流程：

1. **解析清理參數**：

   - 分析 `$ARGUMENTS` 中指定的清理目標
   - 根據參數選擇適當的清理策略
   - 設定安全檢查級別

2. **清理候選識別**：
   根據參數執行不同的檢測策略：

   - **特定工作樹**：直接清理指定目標

3. **風險評估**：

   - 標記需要使用者確認的工作樹
   - 檢查有未推送提交的完成分支

4. **執行清理**：

   - 提供清理建議和互動選項
   - 自動備份重要資訊到 `.claude/worktree-backups/`
   - 使用 `git worktree remove` 安全移除
   - 清理對應的本地分支

5. **清理報告**：
   - 顯示清理統計（移除數量、釋放空間）
   - 提供備份位置和恢復指令
   - 分析清理後的效能提升

為每個清理候選提供詳細的影響分析和恢復選項。

---
description: 列出所有 Git Worktrees 狀態
---

列出目前所有的 Git Worktrees 狀態。

執行 `git worktree list` 並格式化輸出：

- 顯示工作樹路徑
- 顯示對應分支
- 顯示當前所在工作樹（標記 \*）

相關文章

我的 Claude Code 自訂指令－視覺化

先說結論

• 使用 Git Worktree 功能，就像是直接複製好幾個專案同時並行開發，最後可以使用 git 合併回去
• 我設計了四個指令：create、status、done、cleanup
• 配合 Claude Code Max 20x 方案（或其他家類似方案），同時開 5 個工作樹，token 燒好燒滿

Token 大殺器

傳統開發的流程

以前在開發
因為我沒有什麼和人協同開發的經驗

因此版控我也很少開分支
差不多就是做一個功能就 commit
切來切去對我來說反而多此一舉

AI 開發的新思維

有了 AI 後就不一樣了

大部分程式都不是由我寫了

我主要工作變成規劃和分派 AI 執行任務

以效率上來說
讓孜孜不倦的 AI 不停的幫我們開發是最理想的

就好像公司有好幾個工程師
大家都 clone repo 下來
你做 A 功能
我做 B 功能那樣

大概可以這樣理解

把工程師 ⇒ AI 
把 clone repo 這個動作 ⇒ git worktree

什麼是 Worktree？

每個工作樹都是獨立的資料夾
但共用同一個 .git

你可以看下面圖片的資料夾結構可以理解了

工作樹的數量沒有限制
你可以一直建立新的工作樹

因為他等於複製了你的專案
會有限制的是你硬碟的大小

工作樹就是你的專案的分靈體

獨立目錄互不影響

物理上他就是一個獨立的目錄
只是受到 Git 追蹤

所以你可以直接切到該目錄
用 Claude Code 等工具開始開發

或用 IDE 開啟工作樹的目錄開始開發

我習慣分功能開工作樹
或是要寫測試時我也會獨立開工作樹

愛到才知影痛

AI 開發有一個問題會讓人類很痛苦
就是鬼打牆

以前我會跟他拼了
不管是拼命下新的 Prompt
希望 AI 突然開竅

或者下去一行一行看他寫的 code
通常不是一個低級錯誤
就是一大坨大便要重來

最終是可以搞定
但命也去了半條

現在我通常會讓 AI 針對鬼打牆的狀態分析出原因

經過我判斷八九不離十後

我就把這個工作樹刪掉

重新建立新的工作樹
更新需求文件

加上剛剛分析的原因
然後要他開始重做

他也不會抱怨又要重做

而我更像一個奴隸主

不是一個負責擦屁股的救火隊

甘特圖

從圖來看很明顯就可以看出並行開發的效率

工作樹指令

自從有了 AI 後

懶惰的個性被徹底開發了

什麼工作樹的 git 指令要我背那是不可能的

因此我也讓 AI 規劃出了四個工作樹專用的指令

1. /worktree-create：建立工作樹
2. /worktree-done：合併完成的工作樹
3. /worktree-cleanup：刪除工作樹
4. /worktree-status：目前有幾個工作樹

其中建立工作樹的指令有一個小巧思

指令後面可以接著用簡單文字輸入你要建立這個工作樹的目的

系統會幫你用英文命名工作樹名稱和git分支

指令我放在文章最後面

/worktree-done 合併工作樹指令的流程

這個流程圖說明合併工作樹執行的過程

可以感覺一下工作樹的 flow

工作樹生命週期

我讓 AI 幫我畫整個生命週期

我覺得不明覺厲就放上來了

可以幫助你了解整個 flow

累積經驗建立自己的工作流

工作樹概念很簡單

AI 出現後可以玩出各種花來

UI 設計

可以開好幾個工作樹

提供不同的設計風格文件

讓 AI 同時開發

完成後再來挑你喜歡的

或繼續迭代

實驗新技術

開工作樹測試

不行就直接砍掉

不會污染主分支

重構或測試

重構可以和新功能並行開發

不用等重構完才能加新功能

有問題也可以儘早發現問題

砍掉工作樹沒有負擔

再重新優化重構

注意事項

工作樹不是完整複製你的專案

他只會複製有被 Git 版控的檔案

因此像是環境變數 .env 這類型沒有進版控的檔案

新的工作樹目錄是不會有的

因此如果要在工作樹目錄執行

需要把這些重要檔案複製過去

硬碟空間

每個工作樹都是獨立的檔案

如果你的專案很大

記得定期清理

我的 Prompt

我的做法是把指令放在使用者根目錄下

/Users/jackle/

     │
    └─── ? .claude/
          │
        └─── ? commands/
               │
             └─── ? WorkTree/
                         │
                        ├─── ? cleanup.md
                        ├─── ? create.md
                        ├─── ? done.md
                        └─── ? status.md

這樣在 Claude Code 打斜線就能有這樣的指令出現

美觀又直覺

create

---
argument-hint: [name]
description: 建立新的 Git Worktree
---

根據提供的參數建立新的 Git Worktree 並自動設置完整的開發環境。

參數格式：`/worktree-create [name]`

- `name`: 功能描述或識別名稱（必填，AI 會根據內容自動判斷類型）

範例：

- `/worktree-create user-dashboard` → feature/user-dashboard
- `/worktree-create 使用者儀表板重設計` → feature/user-dashboard-redesign
- `/worktree-create 權限驗證修復` → hotfix/permission-validation-fix（AI 識別為修復）
- `/worktree-create 快取效能實驗` → experiment/cache-performance-experiment（AI 識別為實驗）
- `/worktree-create story-1.5-工作流程整合` → story/1.5-workflow-integration（AI 識別為 story）

執行以下流程：

1. **解析和優化參數**：

   - 分析 `$ARGUMENTS` 中的 name 參數
   - AI 根據內容自動判斷 type：
     - 包含「修復」、「fix」、「bug」→ hotfix
     - 包含「實驗」、「experiment」、「測試」→ experiment
     - 包含「story」或數字編號 → story
     - 其他情況 → feature（預設）
   - **中文名稱轉換**：將中文任務名稱轉換為符合命名規則的英文
     - 翻譯成語意清晰的英文詞彙
     - 轉換為 kebab-case 格式（小寫，用連字號分隔）
     - 避免縮寫，確保名稱具描述性
     - 遵循 Fortuna 專案的 4-6 個單字命名原則

2. **建立工作樹**：

   - 使用 `git worktree add` 建立新工作樹
   - 確保目錄和分支命名符合專案規範

3. **完成報告**：
   提供建立結果摘要，包含：
   - 原始中文輸入 → 轉換後的英文名稱
   - 工作樹路徑和分支名稱
   - 下一步指令

執行所有必要的安全檢查，確保不與現有工作樹衝突。

done

---
description: 合併工作樹分支並清理
---

在主目錄中執行工作樹完成流程：選擇並合併工作樹分支到 main，然後清理工作樹。

**使用場景**：當您完成工作樹開發，希望將變更合併回主分支並清理工作樹時使用。

執行以下流程：

1. **環境檢查**：

   - 確認當前位於主目錄中
   - 檢查主目錄工作狀態是否清潔
   - 驗證當前在 main 分支

2. **工作樹分支發現**：

   - 自動掃描所有現有的工作樹
   - 檢查每個工作樹分支的狀態和提交情況
   - 顯示可合併的工作樹分支清單（已有提交且工作目錄清潔）

3. **互動式分支選擇**：

   - 顯示工作樹分支清單，包含：
     - 分支名稱
     - 最新提交訊息
     - 提交時間
     - 工作樹路徑
   - 讓使用者選擇要合併的分支
   - 確認合併操作

4. **執行合併流程**：

   - 更新 main 分支：`git pull origin main`
   - 合併選定的工作樹分支到 main
   - 推送合併後的 main 分支到遠端
   - 執行品質檢查確保合併成功

5. **自動清理**：
   - 刪除已合併的工作樹目錄
   - 移除本地工作樹分支
   - 顯示清理結果

**使用範例**：

```bash
# 在主目錄執行
cd /Users/jackle/workspace/Fortuna
/WorkTree:done
```

**輸出範例**：

```
? 發現以下可合併的工作樹分支：

1. feature/strapi-typescript-optimization
   ? /Users/jackle/workspace/fortuna-feature-strapi-typescript-optimization
   ? feat(typescript): 完成 Strapi v5 TypeScript 優化與 shared 套件建置修正
   ? 2025-07-19 23:41:23

2. feature/workflow-engine-v2
   ? /Users/jackle/workspace/fortuna-feature-workflow-engine-v2
   ? feat(workflow): 實作工作流程執行引擎核心功能
   ? 2025-07-19 15:30:45

請選擇要合併的分支 (輸入數字):
```

**安全檢查**：

- 僅顯示已提交且工作目錄清潔的工作樹
- 合併前確認 main 分支是最新狀態
- 提供合併預覽和確認步驟

**注意事項**：

- 必須在主目錄中執行（非工作樹目錄）
- 確保選定的工作樹已完成所有開發工作
- 合併後工作樹將被自動清理，請確保重要變更已提交

cleanup

---
argument-hint: [target]
description: 智能清理 Git Worktrees
---

智能分析並安全清理 Git Worktrees，確保不遺失重要開發成果。

參數格式：`/worktree-cleanup [target]`

- `target`: 清理目標（可選）
  - 特定工作樹名稱（如 "story-1.4", "feature-dashboard"）
  - 不指定：顯示清理建議但不執行

範例：

- `/worktree-cleanup` （僅分析和建議）
- `/worktree-cleanup story-1.4` （清理特定工作樹）

執行以下清理流程：

1. **解析清理參數**：

   - 分析 `$ARGUMENTS` 中指定的清理目標
   - 根據參數選擇適當的清理策略
   - 設定安全檢查級別

2. **清理候選識別**：
   根據參數執行不同的檢測策略：

   - **特定工作樹**：直接清理指定目標

3. **風險評估**：

   - 標記需要使用者確認的工作樹
   - 檢查有未推送提交的完成分支

4. **執行清理**：

   - 提供清理建議和互動選項
   - 自動備份重要資訊到 `.claude/worktree-backups/`
   - 使用 `git worktree remove` 安全移除
   - 清理對應的本地分支

5. **清理報告**：
   - 顯示清理統計（移除數量、釋放空間）
   - 提供備份位置和恢復指令
   - 分析清理後的效能提升

為每個清理候選提供詳細的影響分析和恢復選項。

status

---
description: 列出所有 Git Worktrees 狀態
---

列出目前所有的 Git Worktrees 狀態。

執行 `git worktree list` 並格式化輸出：

- 顯示工作樹路徑
- 顯示對應分支
- 顯示當前所在工作樹（標記 \*）

相關文章

我的 Claude Code 自訂指令－視覺化