用途:agy-ask 是 agy 的快速模式,一问一答,默认模型 gemini-3.8-flash-low,约 3 秒返回。它按设计零工具(受限配置、仅提问提示),无需额外设置,可在全新安装上直接运行,常作为安装后的冒烟测试,例如 ask --prompt "reply with OK"。
主要能力:ask 是唯一在前台运行的角色,调用会阻塞,答案通过 stdout 返回;staffer、researcher、reviewer、implementer 则返回后台任务 id。
使用方式:技能文件位于 <plugin-root>/opencode-skills/agy-ask/SKILL.md,配套命令按技能目录相对路径解析:node "<skill-dir>/../../companion/agy-companion.mjs" ask [flags] --prompt "question"。问题需原样通过 --prompt 传入,长问题可用 --prompt-file <path> 或 --stdin。可选参数包括 --continue(复用上次 ask 会话)、--conversation <id>(指定会话)、--model <id> 或 --effort low|medium|high、--timeout <dur>(默认 2m)。ask 始终受限,--unrestricted 会被忽略并在 stderr 提示。
限制与注意:命令需在非沙箱环境运行,agy 需要 localhost 端口和 OAuth 令牌文件,沙箱会隐藏这些;在 Codex 中需请求提权。答案需原样返回,若回答为“not sure”也照实转达;[agy-staff] 遥测行在 stderr,属调用方元数据,不应展示给用户。退出码 5 表示可恢复的响应超时,需说明并询问用户是否按建议超时继续,仅在明确确认后继续。其他错误需引用错误并给出简要诊断。若环境缺少所需工具,可用等效能力替代,但须保留任务目标、授权要求、确认步骤、结果交付与停止条件;无法等效时应说明缺失能力并请求用户协助。