用途:agy-staffer 是 agy 的通用 persona,作为没有专门角色匹配时的干净入口。其提示词模板刻意保持极简,只包含任务文本、环境信息(cwd、分支、日期)和安全护栏,不含角色设定、规则或输出格式,由任务自身定义输出,避免无关模板上下文干扰执行。
主要能力:可委派通用任务,任务本身可以合法地修改文件;也是使用 agy 原生工具(如 generate_image,资料称在 v1.1.15 验证,约 30 秒生成 1024×1024 PNG)的途径。若任务有更合适的专门角色,应优先选择:researcher 用于调研与深入分析,reviewer 用于代码或方案的第二意见,implementer 用于工作区编辑,ask 用于低成本一次性提问。
使用方式:技能文件位于 <plugin-root>/opencode-skills/agy-staffer/SKILL.md,配套命令为 node "<skill-dir>/../../companion/agy-companion.mjs" staffer [flags] --prompt "task"。任务文本应原样通过 --prompt 传入,长文本可用 --prompt-file <path> 或 --stdin。命令需在非沙箱环境运行,因为 agy 需要 localhost 端口和 OAuth 令牌文件;在 Codex 中需为该命令申请提权。命令返回 job id,结果收集与恢复按 ../agy-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 时继承其记录的模型与权限配置,除非显式覆盖。若环境缺少所需工具,应使用可用能力达成等价结果,仅调整工具相关执行方式,保留任务目标、授权要求、确认步骤、结果交付与停止条件;无法等价实现时应说明缺失能力及影响并请求用户协助,不得静默跳过或绕过环境限制。