Community寫作與編輯github.com

lessan/jobs

Agent 技能與本地監督器,用於在會話外執行 LLM 任務

jobs 是什麼?

此技能透過 `runjob` CLI 工具,讓 AI 代理能將有明確範圍的工作委派給已安裝的無頭模型 CLI,並維護一個機器層級的執行帳本。它支援兩種執行模式:`runjob run` 用於一次性任務,`runjob fleet run` 用於批次任務、依賴排序、自動隔離工作樹及可恢復的會話。關鍵設計原則是明確授權——只有當使用者明確要求派遣或移交工作時,代理才應啟動任務;解釋、檢查、草稿或規劃等請求不構成授權。技能強調不可變動的文件記錄:所有日誌、提示與工作結果都會儲存在 `${DEV_JOBS_HOME}` 目錄下,工作報告需遵循標準協定並獨立驗證提交與測試結果。此技能適用於 Codex 等支援 `--engine` 與 `--effort` 參數的 CLI 引擎,並提供 `runjob log`、`runjob report` 與 `runjob dash` 等唯讀工具來檢視進行中的工作。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add lessan/jobs

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

工作(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 中的精確協定。將其欄位視為工作的聲明;在合併或發布任何內容之前,請獨立驗證提交、測試和修改的檔案路徑。

相關技能