工作(Jobs)
使用 runjob 將有範圍的工作委派給已安裝的無頭模型 CLI,並維護一個機器層級的執行帳本。請確認 runjob 已在 PATH 環境變數中;若未找到,請引導使用者前往該儲存庫的安裝步驟,而不是自行設法進行機器層級安裝。
啟動工作可能會消耗配額或產生提供者費用。請將明確要求派遣或移交工作的請求視為啟動授權。解釋、檢查、草稿或規劃等請求不構成啟動授權。
選擇執行形式
- 使用
runjob run處理一個有範圍的工作。它會在選定的工作目錄中執行,不會建立分支或工作樹。對於可能編輯或提交的工作,請使用可拋棄的 Git 工作樹或叢集模式。 - 使用
runjob fleet run處理多個工作、依賴排序、自動隔離工作樹、可恢復的會話或每個引擎的並發上限。在建立叢集檔案前,請先閱讀 references/fleet.md。 - 使用
runjob log、runjob report與runjob dash檢查已在進行中的工作。這些是唯讀操作;runjob repair則是一種明確的帳本變更。
當使用者要求在當前對話中進行委派時,請勿將此技能當作會話內的子代理來使用。
一次性工作
對於較長的指示,請使用提示檔案以使派遣過程可審查:
runjob run --engine codex --effort high \
--cwd /absolute/path/to/worktree --file /absolute/path/to/prompt.md
若使用者未選擇 --model 或 --effort,且引擎有合理的 CLI 預設值,則可省略這些參數。請勿虛構目前的模型名稱。當引擎特定旗標、驗證或沙箱行為重要時,請閱讀 references/engines.md。
除非加上 --wait,否則 runjob run 會在啟動後立即返回。請保留輸出的 uid。可使用以下命令進行檢查:
runjob log --uid UID
runjob log --active
runjob report UID --json
runjob dash
日誌與提示可能包含原始碼或敏感指示。它們存放在 ${DEV_JOBS_HOME:-~/.config/dev-jobs} 目錄下;未經獨立審查,請勿發布或附加它們。
完成與移交
請報告 uid、實際請求的引擎/模型、工作目錄,以及工作僅是已啟動還是已完成。請勿將程序啟動描述為成功結果。在等待時,請驗證終端帳本狀態,並總結工作的實際輸出,包括失敗或殘餘工作。
對於機器可讀的工作結束訊息,請使用 references/report-trailer.md 中的精確協定。將其欄位視為工作的聲明;在合併或發布任何內容之前,請獨立驗證提交、測試和修改的檔案路徑。