用途：在已存在 Cursor、OpenCode、Claude 或 OpenAI 版本的工作流中，实现 Gemini 支持的运行器；也可用于研究综合、供应商对比，以及按模型策略选择 Gemini 的工作流。不适用于缺少本地验证机制的仓库改动，也不应把 Gemini CLI 技能等同于 Gemini SDK 运行器。
主要能力与约定：遵循共享工作流契约（agents/research-runner/shared/workflow-contract.ts 中的 WorkflowInput、WorkflowResult 及可选 safetyNotes）。当前没有 Gemini 运行器，需新增 agents/research-runner/gemini/runner.ts 或新工作流目录来实现该契约。docs/gemini-cli-setup.md 记录现有 Gemini CLI 打包方式；agents/research-runner/ 展示多运行时运行器模式；agents/research-runner/shared/ 存放可复用提示词、模板与输出代码。
使用方式：按现有运行器布局镜像实现，把运行器放在其他 harness 变体旁；.gemini/skills 与 .gemini/commands 仅作 CLI 分发资产，SDK 工作流运行器是可执行代码，二者分开。机器决策使用结构化响应，对交接、判定和后续动作解析 JSON。把安全拦截视为工作流状态，返回 blocked 及确切模型/安全原因，而非盲目重试。文件检查、git 检查与测试命令由确定性运行器代码执行。提示词保持共享，仅将 Gemini 专属适配放入 Gemini 适配器。
限制：必须依据官方 Gemini 文档确认当前 SDK 名称与 API，不要凭记忆推断包名、认证、工具调用或流式语义。资料未提供具体 SDK 包名、认证方式、代码示例与收费信息。