用途:gemini-runner 用于把调用方给定的限定提示(scoped prompt)通过本地已认证的 Antigravity CLI(agy)以打印模式执行,面向明确的 Gemini 或 Antigravity CLI 请求及选定的外部路由。确定性检查无需选择模型。
主要能力与用法:先依据 shared/references/model-preview.md 选择分支,再按 shared/references/host-model-execution.md 判断当前主机能否用原生子代理或任务线程派发所选 Gemini 模型;若可以则走原生路由。实际派发使用一个已批准的固定快照,嵌套调用直接消费该快照,不重新解析、不额外启动 worker。调用示例: SKILL_DIR="<absolute path of this skill directory>"; python3 "$SKILL_DIR/scripts/run_gemini.py" "<scoped prompt>" --model <approved-model-id> --disable-fallback --json 需从快照复制所选模型标签、角色、工具模式、回执策略与支持限制。该 runner 没有 effort 标志或原生 effort 控制,需要不受支持控制的路由保持阻塞。
限制与边界:使用本地已认证的 agy 打印模式;模型由用户在 agy 中配置,--model 与输出格式标志只是请求标签或提示,不是原生模型或格式控制。权限检查遵循本地配置,提示与文件上下文可能发送给所配置的提供方。分析角色使用只读提示覆盖层,并非强制沙箱;不可信输入应隔离工作区,--restrict-tools 本身不是安全边界。原生输出无会话 ID,--agy-continue 恢复最近共享会话,且不得对同一 home 并发运行。结果需读取 agent_message 与包装信封,检查成功、服务模型回执、实际 runner/provider 及回退或畸形输出状态;进程完成不等于任务或模型被正确使用。仅在调用方授权编辑时报告被改动的文件。更多标志、认证、回退与续接细节见 references 下对应文档。