規劃與執行

規劃與執行工作流程會將一項工作分配給兩種角色：負責準備與驗收工作的規劃會話，以及負責實際執行的一或多個執行會話。本章說明如何從選單或從會話啟動工作流程、確認任務拆分、選擇工作目錄，以及追蹤工作流程的進度。

1. 工作流程的運作方式

工作流程有兩種角色，每種角色都在側邊欄中以獨立的會話執行：

• 規劃與驗收。 規劃會話會研究任務與專案、為執行會話撰寫工作指派，並驗收每次的結果。在結果符合要求之前，它會持續要求修正；只有在檢查實際變更與驗證證據之後，才會驗收通過。
• 執行。 執行會話負責實作指派的工作並回報結果。修正要求會交給同一個執行會話，因此它在各輪之間都會保留上下文。

執行會話會以規劃會話之子會話的形式顯示在側邊欄中。兩個會話都以會話檢視執行。角色之間互相傳送的訊息會顯示寄件者的智慧體圖示、會話名稱與角色（「規劃」或「執行」），因此您可以在任一方的對話中追蹤雙方的往來。

兩種角色都需要支援會話檢視的智慧體：Claude Code、Codex、OpenCode、Pi 或 OMP。規劃會話與執行會話可以使用不同的智慧體、模型與推理強度。

您可以隨時閱讀、回應或中斷任一會話。任一角色提出的權限請求仍會等待您回應。

2. 從選單啟動

開啟專案、群組或會話的右鍵選單，或其「新增子會話」子選單，然後選擇「新增規劃/執行會話…」。對話方塊包含：

• 「建立位置」：規劃會話的建立位置。執行會話會建立在規劃會話之下。
• 「任務說明」：描述任務、要求與驗收標準。您可以貼上圖片；圖片會隨規劃會話的任務與執行會話的第一次指派一併傳送。
• 「自動拆分多個任務」：請參閱 §4。
• 「規劃與驗收」與「執行」：分別設定每種角色的智慧體（「會話類型」）、「模型」與「推理強度」。模型與推理強度的選項來自所選的智慧體。對話方塊會記住每種角色上次的選擇。
• 「工作目錄路徑」與目錄選項：請參閱 §5。

選擇「建立並啟動」即可啟動規劃會話。計畫就緒後，規劃會話會建立執行會話。僅開啟或取消對話方塊不會建立任何內容。對話方塊有自己的網址，因此您可以複製連結、重新整理頁面，或使用上一頁與下一頁，而不會失去對話方塊。

3. 從會話啟動

在 VelaTerm 啟動的任何會話中執行：

vspawn --plan-execute \
  --plan-agent claude --plan-model opus --plan-effort high \
  --exec-agent codex --exec-model gpt-5.5 --exec-effort medium \
  "Implement the agreed changes and verify all acceptance criteria"

在 Claude Code 中，/vspawn --plan-execute <task> 的作用相同；在 Codex 中請使用 $vspawn --plan-execute <task>。技能會先根據目前的對話撰寫內容完整、可獨立理解的任務，再啟動工作流程。使用這些技能前，需先安裝 Vela 技能（設定 ▸ 一般）。

新的規劃會話會建立在執行該指令的會話之下。請求會先開啟會話派生與 Git 協作 §4 所述的確認卡片，您可以在其中檢查並修改任務與兩種角色的設定。

未明確指定智慧體時，從 Claude、Codex、OpenCode、Pi 或 OMP 會話啟動的規劃會話會使用相同的智慧體；從其他會話啟動時則使用 Claude Code。所選智慧體不支援的模型或推理強度，會在任何內容啟動之前遭到拒絕。

新的會話看不到發起的對話。請在任務中寫明目前已做出的決定、現有的變更、限制條件，以及成果需要交付的位置。

4. 拆分為多項任務

在對話方塊中開啟「自動拆分多個任務」，或在 vspawn --plan-execute 中加入 --split-tasks。規劃會話會先調查工作內容，再提出 1 至 12 項獨立的任務。在您確認之前，不會啟動任何執行會話。

提案會開啟「確認執行任務」對話方塊：

• 在清單中選取任務，即可編輯其「會話名稱」、「任務說明」、智慧體、「模型」與「推理強度」。在任務之間切換時，您的編輯會保留。
• 「移除任務」會刪除一項任務；「復原移除」可將其找回。至少必須保留一項任務。
• 啟動按鈕（「啟動 N 個子會話」）會為每項任務建立一個執行會話。
• 關閉對話方塊後，提案仍會等待確認。此時畫面上會保留「確認執行任務」連結，可再次開啟對話方塊。取消提案會停止工作流程，且不會建立任何執行會話。
• 對話方塊有自己的網址，重新整理後仍會保留；尚未確認的編輯則會在重新整理時遺失。

技能搭配任務拆分使用時，會加入 --yes，因此只會出現這一次最終確認。確認時可以變更每個執行會話的設定，但無法變更已在執行中的規劃會話的設定。

單一規劃會話會接收所有執行會話的回報，並逐項驗收每項任務，每項任務都有各自的修正輪次。只有在所有任務都驗收通過後，整個工作流程才算完成。

拆分任務時，請避免讓不同任務編輯相同的檔案。每個執行會話都會執行各自的智慧體處理程序，因此請依據電腦的資源決定任務數量。

5. 工作目錄與 worktree

目錄選項適用於工作流程中的每種角色：

新的 worktree 從目前的提交建立，不包含尚未提交的變更。如果無法建立 worktree，受影響的會話不會啟動，也不會改用其他目錄。在命令列中，單獨使用 --worktree 等同於 shared。

結果會保留在 worktree 中，直到您將其合併。請在會話上使用「Git ▸ 合併…」合併分支（請參閱會話派生與 Git 協作 §6）。工作流程不會自行合併、推送或刪除 worktree。

6. 追蹤進度

• 規劃會話的對話會即時顯示每次回報與修正。執行會話工作期間，規劃會話會等待其回報。
• vflow status <workflow-id> 會顯示工作流程的狀態、任務、會話與目前輪次。工作流程 ID 會出現在工作流程訊息中。
• vflow stop <workflow-id> 會停止後續輪次，並要求執行中的會話停止。停止整個工作流程會停止其所有任務；停止單一任務則不會影響其他任務。
• vstat 會顯示哪些會話正在工作、正在請求權限或正在等待。執行會話處於等待狀態，不一定代表已完成任務；只有規劃會話的驗收才算數。
• 如果某個角色結束回合時沒有將工作交接出去，工作流程就會進入阻塞狀態。請查看對話、回應需要處理的內容，然後從規劃會話繼續。

這些指令的說明請見會話指令。