agy staffer
通用角色：一个干净的任务入口，用于处理那些不适合任何专业角色的任务。其提示模板刻意保持极简——只有任务文本、环境（当前工作目录、分支、日期）、共享工作规则和安全护栏，没有其他内容。没有角色框架或固定正文格式：任务定义自己的交付物，没有特定领域的模板上下文会引导运行偏离航线。
当有合适的专业角色时请优先使用：researcher 用于调查和深入探究，reviewer 用于代码或计划的第二意见，implementer 用于工作树的编辑，ask 用于一次性的低成本提问。
staffer 同时也是访问 agy 原生产工具的路径，这些工具不被任何专业角色覆盖——尤其值得注意的是 图像生成：agy 自带一个 generate_image 工具（已在 v1.1.15 上验证；约 30 秒生成 1024×1024 PNG）。在任务中指定输出路径，例如 staffer --prompt "生成一个像素艺术机器人吉祥物，保存为 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 需要一个本地端口及其 OAuth 令牌文件，而工具沙箱会隐藏这些。在 Codex 中，请求升级命令权限。详情：
../jobs/references/troubleshooting.md。
收集结果
该命令返回一个作业 ID。阅读 ../jobs/SKILL.md 了解结果收集和恢复：分派、等待最终结果，然后根据需要验证。不要在运行期间主动观察进度、读取日志或检查中间工件。仅当用户明确要求时才观察进度；根据作业协议诊断失败或需要干预的结果。
标志（全部可选）
--prompt <text>/--prompt-file <path>/--stdin——任务，来自这三个来源中的恰好一个。对长提示使用文件/标准输入，而非 Shell 引用。--model <id>或--effort low|medium|high——默认模型为gemini-3.8-flash-medium。--restricted/--unrestricted——权限配置文件；staffer 默认为无限制，与其他使用工具的角色一样，--restricted是可选的安全强化路径。--continue（或--conversation <id>）、--timeout <dur>（默认 60 分钟，最大 120 分钟硬执行限制）。
规则
- 逐字传递用户的任务。由于模板不施加输出格式，当调用方需要特定格式时，请在任务文本中说明所需的格式。
- 逐字传递用户的明确授权。模板默认拒绝代价高昂或不可逆的副作用（提交/推送、删除工作区外的文件、有副作用的网络调用、付费配额的命令）；只有当任务本身请求该操作时，该默认才会打开。
- 通用任务可能合法地编辑文件。配套工具会报告结果中的任何工作树差异——检查它（
git diff）并在在此基础上构建之前确认它符合任务要求。 - 对于错误和恢复，请遵循
../jobs/SKILL.md。
对于已有对话，--continue / --conversation <id> 会继承其记录的模型和权限配置文件，除非明确覆盖。上述无限制默认值适用于新任务。