用途：把研究任务委托给 agy staffer，本身只做“薄壳”——拼命令、执行、原样返回 agy 的报告。适用于用户要求做深度调研或综述的场景。
用法：技能文件位于 <plugin-root>/skills/researcher/SKILL.md，伴随脚本按技能目录相对定位，执行：node "<skill-dir>/../../companion/agy-companion.mjs" research [flags] --prompt "what to research"。用户课题通过 --prompt 原样传入，长简报可用 --prompt-file <path> 或 --stdin。命令须在非沙箱环境运行，因为 agy 需要 localhost 端口和 OAuth token 文件；在 Codex 中需为该命令请求提权。
参数：--continue 复用上次研究会话（省配额，多走缓存），--conversation <id> 指定会话；--model <id> 或 --effort low|medium|high，默认模型 gemini-3.8-flash-high；--restricted / --unrestricted 权限配置，research 默认 unrestricted 无需额外设置，--restricted 为可选加固路径，但部分 agy 原生工具在 headless 下会忽略允许规则，可能导致结果为空；--prompt、--prompt-file、--stdin 三选一提供任务；--timeout <dur> 默认 60m，硬上限 120m。
收集结果：命令返回作业 id；按 ../jobs/SKILL.md 进行结果收集与恢复——派发、等待最终结果、按需校验。不要主动观察进度、读日志或检查中间产物；仅在用户明确要求进度时观察，或在 jobs 协议下诊断失败或需要干预的结果。
规则与限制：不要自行做研究，也不要重新验证 agy 的结论。原样返回伴随脚本 stdout；[agy-staff] 遥测行输出到 stderr（后台运行写入 jobs/<id>.log），是给调用方的元数据，不应展示给用户。把用户明确授权原样写入任务字符串：默认模板会拒绝高成本或不可逆副作用（提交/推送、删除工作区外文件、有副作用的网络调用、消耗付费 API 配额的命令），仅当请求本身要求该操作时才放开，所以不要把“运行 e2e 测试”或“调用 staging API”从 prompt 中删掉。若 --restricted 因权限拒绝返回空响应，转达伴随脚本的指引：先运行一次 setup 流程，或去掉 --restricted。已有会话在 --continue / --conversation 下继承其记录的模型与权限配置，除非显式覆盖；新任务适用上述 unrestricted 默认值。错误与恢复遵循 ../jobs/SKILL.md。