持續執行 Agent 迴圈直到滿足退出條件。當使用者提到「loop」、「babysit」、「keep trying until」、「check every X」、「watch」,或希望進行疊代式的自主執行時使用。
Paseo Loop Skill
迴圈(loop)是一個「執行者/驗證者」(worker/verifier)的週期:啟動 worker → 檢查驗證結果 → 重複執行,直到完成或達到上限。適用於「持續嘗試」、「幫忙盯著(babysit)」或「監控這個狀況直到滿足條件 X」等情境。
若只需在同一個對話中進行輕量級的定期檢查,建議優先使用 cron 心跳(create_heartbeat,完成後再執行 delete_heartbeat)。若要修改心跳設定,請直接刪除並重新建立。當每次疊代都需要完整的 worker/verifier 生命週期時,請使用 loop;若希望每次觸發都建立全新的獨立 Agent 與工作區(workspace),則應使用 schedule。
使用者的參數: $ARGUMENTS
前置作業
請閱讀 paseo skill。在選擇 worker 或 verifier 的模型提供者(provider)之前,除非使用者已在此請求中明確指定 provider,否則請先閱讀 ~/.paseo/orchestration-preferences.json。在讀取該檔案之前,切勿啟動迴圈。
迴圈是 CLI 的基礎原生指令:paseo loop run。可透過 paseo loop ls、paseo loop inspect <id>、paseo loop logs <id>、paseo loop stop <id> 進行管理。
您的任務
- 從
$ARGUMENTS與對話紀錄中理解使用者的意圖。 - Worker 提示詞(prompt) — 必須內容完整自洽,具體說明本次疊代該做什麼,並明確定義何謂「實質進展」。
- 驗證方式(Verification) — 選擇合適的型態:
- Shell 檢查(
--verify-check):適用於可透過指令回答的客觀標準(如gh pr checks --fail-fast、npm test)。 - Verifier 提示詞(
--verify):適用於需要判斷的情境(例如:「僅在所有測試均通過且修改的檔案邏輯連貫時,才回傳 done=true。請附上執行的指令與結果。」)。 - 兩者結合:由 Shell 排除明顯的失敗,再由 Verifier 評估剩餘部分。
- Shell 檢查(
- 提供者(Providers) — worker 使用
--provider,verifier 使用--verify-provider。除非使用者指定,否則從偏好設定檔讀取。若為實作類型的迴圈,建議將 worker 與 verifier 搭配不同的 provider — 這樣能互相補足彼此的盲點。 - 休眠(Sleep) — 僅在輪詢(poll)外部狀態時使用
--sleep。否則讓迴圈依執行速度盡快完成。 - 停止條件(Stops) — 設定合理的
--max-iterations及/或--max-time。未設限的開放式迴圈常是導致程式失控的原因。 - 封存(Archive) — 設定
--archive可以在每次疊代後保留 Agent 狀態以供檢視。 - 使用
paseo loop run啟動。
常見模式
盯 PR(Babysit a PR) — worker 檢查 PR 狀態並修復問題;shell 檢查為 gh pr checks <n> --fail-fast;休眠 2m;max-time 1h。
修測試直到通過(Drive tests to green) — worker 排查失敗原因並修復程式碼;shell 檢查為測試指令;verifier 確認所有測試均通過;max-iterations 10。
跨 Provider 實作(Cross-provider implementation) — worker 使用 impl provider,verifier 使用另一個 provider;verifier 檢查修改的檔案、執行型別檢查(typecheck)與測試;同時限制 max-iterations 與 max-time;開啟 archive 以便檢視每次疊代。
提示詞撰寫規則
Worker — 內容完整自洽、具體(包含指令、檔案、分支、測試、PR、系統等),並明確指出本次疊代何謂「實質進展」。
Verifier — 查核事實、不給出修復建議、引用指令/輸出/檔案證據作為佐證,並具體說明達到「完成(done)」的標準。






