agy staffer
通用型角色：針對不適合任何專家角色的任務所提供的簡潔進入點。其提示模板刻意保持最小化——僅包含任務文字、環境（cwd、分支、日期）、共享工作規則和安全防護措施，沒有其他內容。沒有角色框架或固定輸出格式：任務本身定義其交付物，且沒有特定領域的模板上下文會導致執行偏離軌道。
當有合適的專家角色時，優先使用它們：researcher 用於調查和深入研究，reviewer 用於對程式碼或計畫提供第二意見，implementer 用於編輯工作樹，ask 用於便宜的單次問題。
staffer 也是通往沒有專家角色涵蓋的 agy 原生工具的路徑——特別是圖像生成：agy 附帶一個 generate_image 工具（在 v1.1.15 上驗證過；約 30 秒生成 1024×1024 PNG）。在任務中指定輸出路徑，例如：staffer --prompt "generate a pixel-art robot mascot, save it as assets/mascot.png"。
尋找配套檔案
此技能檔案位於 <plugin-root>/skills/staffer/SKILL.md；相對於此技能目錄解析配套檔案的路徑：
node "<skill-dir>/../../companion/agy-companion.mjs" staffer [flags] --prompt "task"
透過 --prompt 直接傳遞使用者的任務文字；對於長文字，可使用 --prompt-file <path> 或 --stdin。
[!IMPORTANT] 請在無沙箱環境中執行此命令——agy 需要一個 localhost 埠及其 OAuth token 檔案，而 harness 沙箱會隱藏這些資源。在 Codex 中，請請求該命令的提權權限。詳細資訊：
../jobs/references/troubleshooting.md。
收集結果
命令會回傳一個 job ID。請閱讀 ../jobs/SKILL.md 了解結果收集和復原方式：調度、等待最終結果，然後根據需要進行驗證。請勿在執行期間主動觀察進度、讀取日誌或檢查中間產物。僅在使用者明確要求進度時才觀察；若發生失敗或需要介入的結果，請依照 jobs 協定進行診斷。
旗標（皆為可選）
--prompt <text>/--prompt-file <path>/--stdin— 任務，來自這三個來源中的恰好一個。對於長提示，請使用檔案或 stdin 以避免 shell 引號問題。--model <id>或--effort low|medium|high— 預設模型為gemini-3.8-flash-medium。--restricted/--unrestricted— 權限設定檔；staffer 預設為 unrestricted，與其他使用工具的腳色相同，--restricted是選擇性啟用的強化路徑。--continue（或--conversation <id>）、--timeout <dur>（預設 60 分鐘，硬執行上限 120 分鐘）。
規則
- 直接傳遞使用者的任務文字。由於模板不強制任何輸出格式，當呼叫方需要特定格式時，請在任務文字中說明所需的格式。
- 直接傳遞使用者的明確授權。模板預設拒絕昂貴或不可逆的副作用（提交/推送、刪除工作區外的檔案、有副作用的網路呼叫、付費配額的命令）；只有當任務本身要求該操作時，此預設值才會開放。
- 通用任務可能合理涉及編輯檔案。配套檔案會將任何工作樹的變更與結果一起回報——請檢查它（
git diff）並確認這正是任務所要求的，然後再基於它進行建置。 - 若遇錯誤和復原，請遵循
../jobs/SKILL.md。
對於現有對話，除非明確覆寫，否則 --continue / --conversation <id> 會繼承其記錄的模型和權限設定檔。上述對新任務適用的是 unrestricted 預設值。