SuperAPI AI 工具集

ask

测试与质量

查看项目

更新于 10-15 23:45

技能介绍

用途:ask 是 agy-staff 的快速模式,一问一答,默认模型 gemini-3.8-flash-low,约 3 秒返回。它按设计零工具(受限配置、仅提问提示),无需额外设置,可在全新安装上直接运行,常作为安装后的冒烟测试,例如 ask --prompt "reply with OK"。

主要能力:ask 是唯一在前台运行的角色,调用会阻塞,答案通过 stdout 返回;staffer、researcher、reviewer、implementer 则返回后台任务 id。支持 --continue 复用上一次 ask 会话,--conversation <id> 指定会话,--model <id> 或 --effort low|medium|high 调整模型与强度,--timeout <dur> 设置超时(默认 2m)。问题可通过 --prompt、--prompt-file <path> 或 --stdin 三者之一传入,长问题建议用文件或标准输入。

使用方式:技能文件位于 <plugin-root>/skills/ask/SKILL.md,配套命令按技能目录相对路径解析:node "<skill-dir>/../../companion/agy-companion.mjs" ask [flags] --prompt "question"。需在非沙箱环境运行,因为 agy 需要 localhost 端口和 OAuth 令牌文件;在 Codex 中需为该命令申请提权。ask 始终受限,--unrestricted 会被忽略并在 stderr 提示。

限制与注意:应原样传递用户问题并原样返回答案;[agy-staff] 遥测行在 stderr,属于调用方元数据,不应展示给用户。若答案表示不确定,应如实转达,不要自行替换。退出码 5 表示可恢复的响应超时,需说明并询问用户是否按建议超时继续,仅在明确确认后使用记录的会话与配置继续。其他错误应引用错误信息并给出简要诊断。