在 Plan Studio 中工作

本指南說明如何在 Plan Studio 中處理計畫。關於編排與計畫文件究竟是什麼，請參閱編排與使用計畫模式。

開啟計畫

計畫隸屬於產生它的那段對話，因此你通常也是在對話裡開啟它：對話中該計畫所在的列有一個開啟動作，而 Plan Studio 會以編輯器分頁的形式在對話旁邊開啟。

中心頁列出三個區段：

點選卡片即可在 Plan Studio 中開啟它。路由是 /workspaces/<workspace-id>/plans/<kind>/<plan-id>，其中 kind 是 orchestration 或 document，所以你也可以對單一計畫使用深層連結。

如果你開啟的是編排，你會看到可編輯的畫布、版本時間軸與核准列。如果你開啟的是 計畫文件，同一張圖會以唯讀方式呈現 —— 計畫文件由代理撰寫；你檢閱、預估並核准或拒絕它們，而已核准的文件會顯示它所編譯成的編排中每個節點的即時執行狀態。

編排處於 proposed 時可以編輯。所有畫布編輯都以鍵盤操作：

在檢查器中，你也可以編輯步驟的描述、角色與輸出結構描述。編輯會在短暫停頓後自動儲存為新的修訂版；驗證錯誤（顯示於核准列）會阻止儲存，直到你修正為止。

只有工作步驟可以編輯。結構性節點 —— 研究、討論與綜合 —— 是唯讀的，任何工作已經執行過的步驟也是（它會被標示為「已執行」，因為編輯它會讓計畫分叉）。

儲存是以你開始時所在的修訂版進行樂觀並行控制。如果編排器在你底下重新規劃，你的儲存會被拒絕並顯示「計畫已變更」，而不是被合併或悄悄覆蓋；請重新讀取目前的修訂版並重做你的編輯。代理發起的重新規劃本身有速率限制，每兩分鐘只能一次，因此這種情況很少發生。

按核准列中的預估。

畫布上的每個步驟都會得到一個徽章，內含成本區間以及支撐該區間的樣本數；當該步驟的角色從未執行過時，則顯示「尚無歷史紀錄」。選取某個步驟可在檢查器中查看完整詳情：含樣本數的成本區間、所需時間區間，以及由該步驟的出處推導出的影響範圍（檔案與符號）—— 若該步驟沒有出處，則顯示「未知」。
核准列會顯示計畫總計：整體成本區間、關鍵路徑的所需時間區間（平行分支會重疊，因此這不是各區間之和），以及計畫有設定時的預算上限。
如果只有部分步驟有歷史紀錄，總計會標示為部分，且只涵蓋可預估的步驟。如果預估的高標超出預算上限，總計會轉為紅色並附上超出預算的警告。

預估要嘛誠實，要嘛從缺：角色沒有已完成執行歷史的步驟會回報樣本數為零，且完全不給任何區間，並顯示為未知，而不是靠猜測。請把「尚無歷史紀錄」理解為「沒人知道」，而不是「很便宜」。

預算上限只是與這份預估做顯示上的比較。計畫開始執行後，沒有任何機制會強制執行它 —— 關於真正能停止支出的控制項，請參閱管理成本。

每一次編輯，以及編排器的每一次重新規劃，都會附加到一個只增不減的修訂版時間軸上，該時間軸顯示在編排計畫左側的版本面板中。

propose_orchestration 與編輯器都會在計畫不再是 proposed 之後拒絕變更，因此進行中的執行不會採納執行中途的重新規劃。

在應用程式中，已提出的計畫是一次整體做出的決定：核准列中的核准計畫或拒絕。核准計畫一律會核准每一個步驟 —— 沒有辦法先選取子集。當提案有驗證錯誤時，核准會被阻止，這些錯誤會顯示在按鈕旁邊。

核准僅限操作員。它沒有對應的 MCP 工具，因此代理可以提出並修訂計畫，卻永遠無法核准計畫。

一旦編排進入執行階段，核准列就會改變：

如果某個步驟在執行中途停下來提問，選取它並按繼續節點讓它繼續。
按核准所選可將_部分_核准擴大到所選步驟以及它遞移相依的一切（步驟永遠不能在沒有其相依項的情況下被核准）。這個控制項會出現在每個編排的執行中列上；當計畫是整體核准時，它不會有任何作用。
按取消執行停止整個編排。

部分核准集合之外的步驟會呈現為已延後，在你擴大該集合之前不會執行。

Playbook 是一份已儲存的計畫範本，其目標、步驟標題、描述與提示中帶有具型別的 {{param}} 預留位置。替換是字面上的 —— 沒有運算式語言；如果你需要邏輯，請改用管線。

執行 playbook 只會提出一份計畫 —— 實例化後的編排會以 proposed 在 Plan Studio 中開啟，在你於該處核准它之前什麼都不會執行。要移除某個 playbook，請按它卡片上的垃圾桶圖示。

代理使用 create_playbook 與 run_playbook 這兩個 MCP 工具建立與執行 playbook；請參閱 MCP 工具參考。