---

name: gemini-cli-bridge description: Use when you want Codex to invoke the local Gemini CLI (gemini) to generate/rewrite/summarize/review content (code, diffs, docs). The workflow runs gemini in one-shot or prompt-interactive mode, captures output, then lets Codex decide the next concrete actions (edits, tests, follow-up prompts).

Gemini CLI Bridge

目标：让 Codex 通过终端的 gemini 命令把“生成/评审/总结”交给 Gemini CLI，然后把结果变成可执行的下一步（改哪些文件、跑哪些命令、需要哪些澄清）。

前置检查（每次开始都做）

1. 确认 CLI 可用

Copygemini --version
gemini --help

1. 认证/登录

本 Skill 不负责登录流程。如果 gemini 提示未登录或缺权限，先让用户完成登录，然后再继续。

推荐工作流（Codex 执行顺序）

1. 明确“委托给 Gemini 的子任务”

• 生成：写一段内容/方案/测试用例草案/文档草案
• 评审：对某个文件、diff、或一段文本做 review，输出问题清单 + 建议改动
• 总结：把一段长输出压缩成可执行 TODO

1. 组装提示词（Prompt）并约束输出格式

• 强制 Gemini 输出：结论 / 依据 / 建议改动 / 风险（或你需要的结构）
• 如果是评审代码：要求逐条列出问题，并按严重程度排序

1. 调用 gemini（优先用 one-shot）

• 轻量 prompt：直接用 positional prompt
• 需要带长上下文：把上下文放在 prompt 里，或用 stdin + --prompt（注意：--prompt 在 CLI 帮助里标记为 deprecated，但当前版本可用）

1. 保存“输入/输出”以便可复现

• 至少保存：prompt、gemini 输出（最好加上时间戳文件名）

1. Codex 决策下一步

• 从 Gemini 输出中提取可执行动作：改文件、跑测试、补充信息
• 避免把 Gemini 输出当成最终真理：对关键结论进行二次验证（跑命令/查代码/查文档）

命令模板（可直接用）

One-shot：prompt 很短

Copygemini --output-format text "在不改变行为的前提下，帮我把下面的内容改得更清晰：..."

One-shot + JSON：便于后处理

Copygemini --output-format json "请输出结构化结果：{结论, 问题列表, 建议, 风险}"

带上下文：stdin + prompt（当前版本可用，但 --prompt 标记为 deprecated）

Copycat CONTEXT.txt | gemini --output-format text --prompt "请基于以上上下文做 review，并输出：结论/问题/建议/风险"

Bundled Scripts

• scripts/gemini-run.sh：把 prompt/context 组合成一次 gemini 调用，并可选写入输出文件

gemini-run.sh 示例

从仓库根目录调用（未安装 skill 的情况下也能用）：

Copyecho "请把下面的段落改写得更专业（输出 Markdown）" > /tmp/prompt.txt
./skills/gemini-cli-bridge/scripts/gemini-run.sh --prompt-file /tmp/prompt.txt --output-format text

用 diff 做 review（把 diff 走 stdin）：

Copyecho "请对下面的 diff 做 review，输出：结论/问题清单(按严重程度)/建议改动/风险" > /tmp/prompt.txt
git diff | ./skills/gemini-cli-bridge/scripts/gemini-run.sh --prompt-file /tmp/prompt.txt --context-file - --output-format text