SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-15 21:46

技能介绍

用途:把用户的深度研究问题交给 Gemini 的 deep-research 托管代理执行,等待完成并返回带引用的报告。适用于用户要求“deep research”式调研的场景。

主要能力:可选择两个模型,deep-research-preview-04-2026(默认)与 deep-research-max-preview-04-2026(max 模式,更慢、投入更高),用 --max 选择。脚本为 ${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py,自带守护进程化:research 立即返回 run_id,由分离的 worker 执行研究,状态文件在完成时变为 completed / failed。深度研究可能耗时数分钟。

使用方式:需要环境中提供 GEMINI_API_KEY,且 uv 在 PATH 中。 第一阶段框定问题:用完整的 $ARGUMENTS 文本(去掉 --max)作为研究问题;若过于空泛,先向用户提一两个澄清问题。 第二阶段启动运行:uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" research --query "<question>" [--max],从 stdout 捕获 run_id、output_file 与 wait_command;若报告错误(例如缺少 GEMINI_API_KEY)则呈现错误并停止。 第三阶段等待完成:对 wait_command 启动 Monitor,命令为 uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" wait --run <run_id> --timeout 1800;Monitor 的 timeout_ms 建议设为 3600000(60 分钟,即等待超时的两倍)。收到事件后查看是否含 : completed、: failed 或 : timeout,前两者进入第四阶段;timeout 表示仍在运行,可再次启动 Monitor 继续等待,连续四次超时(共 4 小时)后告知用户仍在运行并给出完整命令 uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" status --run <run_id> --full 以便稍后获取,然后停止。不得把超时/仍在运行状态当作报告呈现。 第四阶段报告结果:uv run "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.py" status --run <run_id> --full,或直接读取 output_file;向用户展示报告文本并保留引用与来源;若状态为 failed,报告记录的错误与可能原因。

限制:使用的是 Gemini 托管深度研究代理,其自行管理搜索与浏览,不涉及沙箱工具或网络标志;深度研究耗时较长;需 GEMINI_API_KEY 与 uv;共享 API 面与限制见 ../delegate/references/usage.md。其他收费、价格等信息暂未提供。