用途:staffer 是 agy 的通用人格,作为不属于任何专门人格任务的干净入口。其提示模板刻意保持极简,只包含任务文本、环境信息(cwd、分支、日期)与安全护栏,没有角色设定、规则或输出格式,由任务自身定义输出。若任务有更合适的专门人格,应优先选用:researcher 用于调研与深度分析,reviewer 用于对代码或方案的第二意见,implementer 用于修改工作树,ask 用于低成本的一次性提问。
主要能力:作为 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。命令需在不沙箱环境下运行,因为 agy 需要 localhost 端口与其 OAuth token 文件;在 Codex 中需为该命令申请提权。命令返回 job id,按 ../jobs/SKILL.md 进行派发、等待最终结果与恢复;除非用户明确要求查看进度,否则不要主动观察进度、读取日志或检查中间产物。
可选参数:--model <id> 或 --effort low|medium|high(默认模型 gemini-3.8-flash-medium);--restricted / --unrestricted(staffer 默认 unrestricted,--restricted 为可选加固路径);--continue 或 --conversation <id>;--timeout <dur>(默认 60m,最长 120m 硬性执行上限)。
规则与限制:原样传递用户任务文本;因模板不施加输出格式,需要指定格式时须在任务文本中说明。原样传递用户的明确授权;模板默认拒绝高成本或不可逆副作用(提交/推送、删除工作区外文件、有副作用的网络调用、消耗付费配额的命令),仅当任务本身要求该操作时才放开。通用任务可能修改文件,配套工具会随结果报告工作树差异,需用 git diff 检查确认后再基于其继续。已有会话用 --continue/--conversation 继承记录的模型与权限配置,除非显式覆盖;上述 unrestricted 默认仅适用于新任务。其他细节与排错参见 ../jobs/SKILL.md 与 troubleshooting.md。