用途：agy-researcher 用于把深度研究或调研任务委派给 Google 的 Antigravity CLI（agy staffer，快速 Gemini）。触发方式为用户输入 /agy-researcher，或说“ask agy to research”等。该技能本身是薄壳：构造命令、运行、原样返回 agy 的报告，不自行研究，也不复核 agy 的结论。
主要能力与用法：通过共享伴随脚本调用，命令形式为 node "<skill-dir>/../../companion/agy-companion.mjs" research [flags] --prompt "what to research"。研究主题用 --prompt 原样传入；长简报可用 --prompt-file <path> 或 --stdin。命令返回 job id，结果收集与恢复需参考 ../agy-jobs/SKILL.md：派发、等待最终结果、按需校验；运行期间不要主动观察进度、读日志或检查中间产物，仅在用户明确要求进度或按 jobs 协议诊断失败时观察。
可选参数：--continue 复用上一次研究对话（省配额，多由缓存提供），--conversation <id> 指定具体对话；--model <id> 或 --effort low|medium|high，默认模型为 gemini-3.8-flash-high；--restricted / --unrestricted 权限配置，research 默认 unrestricted，开箱即用，--restricted 为可选加固路径，agy 不使用 --dangerously-skip-permissions 且仅能用允许列表工具，需要先跑 setup 流程的取证允许列表，且部分原生 agy 工具在无头模式下会忽略允许规则，受限运行可能返回空；--timeout <dur> 默认 60m，硬上限 120m。
限制与注意：命令需在非沙箱环境运行，因为 agy 需要 localhost 端口和 OAuth 令牌文件，沙箱会隐藏这些；在 Codex 中需为该命令请求提权。伴随 stdout 原样返回，[agy-staff] 遥测行输出到 stderr（后台运行写入 jobs/<id>.log），属于给调用代理的元数据，不应展示给用户。用户明确授权需原样传入任务字符串，提示模板默认拒绝高成本或不可逆副作用（提交/推送、删除工作区外文件、有副作用的网络调用、消耗付费 API 配额的命令），仅当请求本身要求该操作时才放开。若 --restricted 因权限被拒返回空响应，转达伴随脚本指引：先跑一次 setup 流程，或去掉 --restricted。已有对话的 --continue / --conversation <id> 会继承其记录的模型与权限配置，除非显式覆盖。宿主兼容性方面，若环境缺少所需工具，可用现有能力实现等价结果，但只调整工具相关执行方式，保留任务目标、授权要求、显式确认步骤、结果交付与停止条件；无法等价实现时应说明缺失能力及影响并请用户协助，不得静默跳过或绕过环境限制。