目標
目標是 Perch 自行一個回合接一個回合追下去的目的,並由一道獨立檢核判斷它是否真的完成,直到完工或預算用盡。
一般的回合做完你要求的事就停下來。若這件工作需要十二個步驟,你就得一直說「繼續」。目標把這件事去掉了:你只說一次目的,Perch 便一個回合接一個回合地重新啟動自己,直到一道獨立檢核同意工作已經完成。
The short version
/goal <objective>。它會跨越多個回合執行,在你離開後仍存在,並在 40 個回合或 4 小時時自行停止。單獨輸入 /goal 會顯示目前的進展。設定一個目標
/goal make the test suite pass
/goal reconcile every invoice in this folder against the ledger and write up the exceptions當工作有很多步驟,而且終點是你能用嘴說清楚的,就用目標。單一問題別用它:一個本來一個回合就能做完的目標,只是多加一道檢核而已。
用一字不差的同一段目的文字再次執行 /goal,會接續你既有的目標並保留回合計數。文字不同則會開一個新的。
觀察與引導
| 指令 | 作用 |
|---|---|
/goal | 顯示目標:狀態、已用回合數、上次停下來的原因,以及完成度檢核最後說了什麼。 |
/goal pause | 暫停它但不丟掉。 |
/goal resume | 從停下的地方接續。 |
/goal clear | 放棄它。stop、off、cancel 與 reset 也都可以。 |
/goal status 與單獨的 /goal 相同,/goal continue 與 /goal resume 相同。
目標執行期間,你會隨著它進行看到每個回合,以及其中的工具呼叫。在桌面版按 Esc,或在 CLI 於輸入框為空時按 Esc、或按 Ctrl-C,都會停止目前的執行。
完成度檢核
Perch 不會光憑自己一句話就認定目標完成。當一次執行宣告目的已達成時,會有另一道檢核來審視這個說法,結果可能有三種:
- 已達成。 這次執行以完成作結。
- 未達成。 Perch 會依檢核找到的內容繼續工作。若執行就在那裡結束,它會告訴你缺了什麼,你可以接續。
- 無法達成。 檢核發現這個目的根本無法達成。執行會停止並說明原因,讓你可以改目標,而不是繼續把回合燒在上面。
檢核最後說的內容是 /goal 狀態的一部分,因此你隨時都能看到它還在等什麼。
一次執行會在哪裡停下
目標不會永遠跑下去。除了 Complete 之外的每一種結束狀態,都可以用 /goal resume 接續。
| 停止原因 | 代表什麼 |
|---|---|
| Complete | 完成度檢核通過了。 |
| Budget | 已達 40 個回合或 4 小時實際時間。你得到的是部分進度。 |
| Incomplete | 某個回合沒有任何工具呼叫,也沒通過檢核,因此它選擇停下而不是空轉。 |
| Blocked | 有個動作需要你核准,或是這次執行碰上了無人看顧時做不了的事。 |
| Paused | 你暫停了它,或是某個用量上限暫停了它。 |
| Failed | 某個回合發生錯誤。 |
| Cancelled | 你把它停掉了。 |
| Interrupted | 這次執行的程序死掉了,例如應用程式在回合進行到一半時結束。 |
某個步驟停止回應時,也會結束這次執行,而不是一直掛著。
權限模式在這裡很關鍵
目標是設計來在你不在場時執行的,而 Default 權限模式在第一次寫入或執行指令時就會停下來詢問。因此在 Default 下啟動的目標,該次執行會以 Auto Review 進行,Perch 在開始時就會說明:可還原的工作自行執行,風險較高的動作仍要經過安全檢查。Take the Wheel 與 Plan 則維持你設定的樣子。
Auto Review 對風險最高的動作仍會來問你。發生時目標會回報 Blocked 並等待。請參閱權限模式。
它在你離開後仍存在
目標會與它的討論串一起儲存,因此比工作階段活得更久。離開 CLI、關閉桌面版,或重新載入頁面,之後回到同一個資料夾或討論串,執行 /goal resume 即可。目的與回合計數都還在。
目標按討論串保存帶來兩個結果。在某個資料夾的討論串設下的目標,從另一個資料夾看不到,因為 CLI 會把預設討論串綁在你的工作目錄上。另外,因用量上限而暫停的目標,可能會自行恢復,直到你自己開始一個回合為止;而你自己暫停的目標,絕不會自行恢復。
