mcpField
G
gemini-runner

gemini-runner

github.com/robsonrungAgent 工作流277 次安装3 天前更新
代码仓库

关于 gemini-runner

通过本地 Antigravity CLI `agy` 执行调用方限定的提示，并遵循已批准的 Gemini 模型快照。它会核对实际响应的模型与路由结果，不把进程完成视为任务成功的证明。

主要功能

  1. 01通过本地 `agy` CLI 执行提示
  2. 02使用已批准的 Gemini 模型快照
  3. 03核对提供方及实际服务模型回执
  4. 04报告回退和格式错误输出
  5. 05按配置继续共享对话

适用场景

  1. 01向 Gemini 分派限定范围的任务
  2. 02确认实际响应的提供方
  3. 03处理不可用或未经验证的模型路由
  4. 04继续共享的 CLI 对话

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/robsonrung/rar-skills --skill gemini-runner

安装后在 Claude Code 中输入/gemini-runner确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
command-reference.md
continuation.md
runtime-reference.md
scripts/
run_gemini.py
tests/
test_run_gemini.py

详细介绍

Gemini Runner

先使用 shared/references/model-preview.md 选择分支。确定性检查无需选择模型。实际调度使用一个具体且已批准的快照；嵌套调用会沿用该快照，不会重新解析或启动额外的工作器。

通过本地 CLI 执行调用方限定范围内的提示词。共享角色、信封键和结果处理方式见 shared/references/runner-common.md。保持席位忠实度：注明实际作答的提供方，并如实报告不可用或未经验证的席位。

原生路由

选择外部路由前，请阅读 shared/references/host-model-execution.md。如果当前宿主能在原生子 Agent 或任务线程中调度精确选定的 Gemini 模型，并满足所需的推理力度、隔离和回执策略，请使用该路由。agents/openai.yaml 是宿主 UI 元数据；它不会调度原生模型。

调用

在同一次 shell 调用中，将 SKILL_DIR 设为此已加载技能目录：

SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_gemini.py" "<scoped prompt>" \
  --model <approved-model-id> --disable-fallback --json

从快照中复制选定的模型标签、角色、工具模式、回执策略和受支持的限制。本运行器没有推理力度标志或原生推理力度控制。需要不受支持控制的路由会保持阻止状态。嵌套调用会使用已保存的选项，不会再次解析默认值。此示例不授予源共享权限或工具权限。

运行时边界

  • 使用本地已认证的 Antigravity CLI agy，并以打印模式运行。
  • 用户在 agy 中配置模型。--model 和输出格式标志只是请求标签或提示词提示，并非原生模型或格式控制。
  • 权限检查遵循本地配置。提示词和文件上下文可能会发送给已配置的提供方。
  • 分析角色使用只读提示词覆盖，而非强制沙箱。处理不可信输入时，请隔离工作区；仅使用 --restrict-tools 并不能构成安全边界。
  • 缺少 CLI 时的回退方案会在运行时参考文档中标注并说明。已批准的路由使用 --disable-fallback；未经验证的模型需要调用方明确指定回执策略。
  • 原生输出没有会话 ID。--agy-continue 会恢复最新的共享对话，因此不得在同一 home 目录下并发运行。

按需加载

结果

读取 agent_message 和包装器信封。检查执行是否成功、服务模型回执、实际运行器／提供方，以及是否存在回退或格式错误状态。进程已完成并不能证明执行了请求的任务或使用了请求的模型。若调用方授权了编辑，请报告修改过的文件。

评论

支持 Markdown