Gemini CLI 工具映射实战：让 AI 编程超能力 Skills 在 Google Gemini CLI 上真正跑起来

AI 技能AI 插件人工智能开发工具【免费下载链接】superpowers-zh AI 编程超能力 · 中文增强版 — superpowers250k ⭐完整汉化 4 个中国原创 skills让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活项目地址https://gitcode.com/gh_mirrors/su/superpowers-zh点击查看免费下载导读本文是 superpowers-zhAI 编程超能力中文增强版为 Gemini CLI 用户提供的工具映射权威指南。Skills 本身只描述动作——分派子智能体、建待办、读文件——而不同的 AI 编程工具要用各自的原生工具来实现这些动作。本文逐项列出 Gemini CLI 的等价工具、GEMINI.md指令文件加载机制、个人 skills 目录布局、invoke_agent子智能体分派与并行策略以及 Gemini CLI 独有的扩展工具并结合作业仓库的实际源码与文档给出可直接照抄的落地配置。读完你将掌握如何在 Gemini CLI 中调用 superpowers 的 20 个 skills、如何用generalist语法分派子智能体并正确填写提示词模板、如何让子智能体并行工作。一、核心思想Skills 说动作Gemini CLI 提供工具superpowers 的每个 skill如subagent-driven-development、requesting-code-review、systematic-debugging都写在各自的 SKILL.md 里描述的是动作层面的工作流分派一个子智能体、建一条待办、读一个文件。这些动作在 Gemini CLI 上必须映射到它自己的原生工具。底层映射表由 gemini-tools.md 定义并经由仓库根目录的 GEMINI.md 第 2 行./skills/using-superpowers/references/gemini-tools.md自动加载给 Gemini CLI 会话。Skill 请求的动作Gemini CLI 等价工具读取一个文件read_file一次读取多个文件read_many_files创建新文件write_file编辑文件replace执行 shell 命令run_shell_command搜索文件内容grep_search按名称查找文件glob列出文件和子目录list_directory抓取 URLweb_fetch搜索网页google_web_search调用一个 skillactivate_skill分派子智能体Subagent (general-purpose):模板invoke_agentagent_name: generalist也可用generalist聊天语法调用多个并行分派同一条响应里发多个invoke_agent调用任务跟踪建一条待办、标记完成write_todos状态pending、in_progress、completed、cancelled、blocked这份映射的实践意义在于任何一个 superpowers skill 内部出现的读文件搜索代码分派审查者更新待办在 Gemini CLI 会话中都会被翻译成上表中的某个原生调用因此 skill 的流程约束例如using-superpowers要求任何响应之前先调用 Skill 工具才能在 Gemini CLI 上得到执行。二、指令文件GEMINI.md 的层级加载机制当某个 skill 提到你的指令文件时在 Gemini CLI 上指的是GEMINI.md。这与 Claude Code 的CLAUDE.md、Hermes Agent 的AGENTS.md是同一个角色——承载项目工作方法论与技能清单的常驻上下文。Gemini CLI 按层级加载GEMINI.md全局级~/.gemini/GEMINI.md对所有项目生效项目级工作区目录及其各级父目录里的GEMINI.md子目录级当某个工具访问子目录中的文件时该子目录下的GEMINI.md也会被加载。这意味着你可以把组织级规范放在全局把项目专属流程放在项目根目录把局部模块的约定放在对应子目录。superpowers-zh 仓库根目录的 GEMINI.md 就是典型用法它先用./skills/using-superpowers/SKILL.md和./skills/using-superpowers/references/gemini-tools.md两条导入语句把技能框架与工具映射带进会话再写下四条核心规则收到任务先检查 skill、设计先于编码、测试先于实现、验证先于完成最后列出全部 20 个可用 skills 及触发条件——Gemini CLI 会话启动后即可按此执行。值得注意的还有扩展配置 gemini-extension.json 中的contextFileName: GEMINI.md字段它声明了该扩展以GEMINI.md为上下文文件名这正是 Gemini CLI 扩展模式下自动把项目GEMINI.md注入会话的依据。三、个人 Skills 目录~/.gemini/skills/与跨运行时共享用户级 skills 放在~/.gemini/skills/而~/.agents/skills/是跨运行时的别名目录与 Codex、Copilot CLI 共用。当同一层级下两个目录都存在时.agents/skills/优先。每个 skill 是一个子目录里面有一份带name和descriptionfrontmatter 的SKILL.md。例如本仓库的skills/brainstorming/SKILL.md以name: brainstorming和description: 在任何创造性工作之前必须使用此技能…开头Gemini CLI 靠这段 frontmatter 做 skill 发现与按需加载。这一布局在 docs/README.codex.md 中有补充说明.agents/skills是 Agent Skills 开放约定与 Codex CLI 等工具共用并非冲突——在一个运行时里装好另一个也能读到。结合 docs/README.gemini-cli.md 的加载优先级表.gemini/skills/为最高优先级的项目级目录仅当前项目生效~/.gemini/extensions/*/skills/为扩展级目录所有项目共享用户级~/.gemini/skills/则介于两者之间按上述规则参与合并。若你在自己的项目中使用 superpowers-zh可参考 docs/README.gemini-cli.md 的两种安装方式# 自动安装检测 .gemini/ 目录并复制 skills cd /your/project npx superpowers-zh # 手动安装 git clone https://github.com/jnMetaCode/superpowers-zh.git cp -r superpowers-zh/skills /your/project/.gemini/skills也可以作为 Gemini 扩展全局安装mkdir -p ~/.gemini/extensions/superpowers-zh/skills cp -r superpowers-zh/skills/* ~/.gemini/extensions/superpowers-zh/skills/ cp superpowers-zh/gemini-extension.json ~/.gemini/extensions/superpowers-zh/若 skills 未生效按 docs/README.gemini-cli.md 的故障排查清单核对.gemini/skills/目录是否存在且包含 skill 文件夹、每个SKILL.md是否有有效 YAML frontmatter最后重启 Gemini CLI。四、子智能体支持invoke_agent 与 generalistGemini CLI 通过invoke_agent工具分派子智能体该工具接收agent_name和prompt两个参数。同一个分派动作也有聊天语法快捷方式输入generalist prompt等价于以agent_name: generalist调用invoke_agent。内置的 agent 名包括generalist通用子智能体skills 中的Subagent (general-purpose):分派默认对应它cli_help解答 Gemini CLI 自身使用问题codebase_investigator代码库调查专用browser_agent启用浏览器工具后可用。4.1 分派形式对照skills 用Subagent (general-purpose):分派时要么引用一个提示词模板文件要么直接给出内联提示词。两种形式在 Gemini CLI 上的等价做法如下Skill 里的分派形式Gemini CLI 等价做法引用某个*-prompt.md模板implementer、task-reviewer、code-reviewer 等把模板填好然后以agent_name: generalist和填好的提示词调用invoke_agent引用requesting-code-review的./code-reviewer.md以agent_name: generalist和填好的审查模板调用invoke_agent内联提示词没有引用模板以agent_name: generalist和你的内联提示词调用invoke_agent以仓库实际模板为例subagent-driven-development/SKILL.md 的分派流程引用./implementer-prompt.md实现者模板、./task-reviewer-prompt.md任务审查者模板与./re-review-prompt.md定向复审模板requesting-code-review/SKILL.md 则要求使用code-reviewer.md模板见 code-reviewer.md。在 Gemini CLI 上执行时控制者把这些模板文件读进来、填好占位符再用invoke_agent把完整提示词交给generalist子智能体执行。4.2 填写提示词Skills 提供的提示词模板里有{WHAT_WAS_IMPLEMENTED}或[FULL TEXT of task]这类占位符。把所有占位符都填好再把完整提示词交给invoke_agent。模板本身就包含了该 agent 的角色、审查标准和期望的输出格式——子智能体会照着它执行。具体占位符可对照 code-reviewer.md 末尾的说明{DESCRIPTION}填已构建内容的简要说明{PLAN_OR_REQUIREMENTS}填预期功能计划文件路径、任务文本或需求{BASE_SHA}填起始 commit{HEAD_SHA}填结束 commit。而 requesting-code-review/SKILL.md 中的完整示例展示了从获取BASE_SHA/HEAD_SHAgit rev-parse HEAD~1与git rev-parse HEAD、派遣审查子代理、到按 Critical/Important/Minor 分级处理反馈的完整闭环——审查者返回的优点 / 问题Critical、Important、Minor/ 建议 / 评估结构正是模板要求的输出格式。4.3 并行分派Gemini CLI 支持并行分派子智能体在同一条响应里发出多个invoke_agent调用或在一个提示词里写多个generalist调用即可让相互独立的子智能体工作并行跑。这与dispatching-parallel-agentsskill 的思路一致——2 个以上可独立、无共享状态或顺序依赖的任务应当并行。有依赖关系的任务保持串行但不要为了让历史记录简单一点就把相互独立的子智能体任务串起来并行能显著压缩墙钟时间而把独立任务串行只会白白烧掉会话轮次。五、Gemini CLI 额外工具以下工具是 Gemini CLI 独有的在其他运行时如 Codex、Hermes、Copilot CLI的映射表中没有对应物工具用途save_memory旧版当experimental.memoryV2 false时跨会话持久化事实get_internal_docs查阅 Gemini CLI 自带的文档ask_user向用户提出结构化问题文本 / 单选 / 多选enter_plan_mode/exit_plan_mode进入和退出只读的计划模式update_topic更新当前会话的主题 / 战略意图元数据complete_task表示某个 Gemini 子智能体已完成并把结果返回给父 agenttracker_create_task、tracker_update_task、tracker_get_task、tracker_list_tasks、tracker_add_dependency、tracker_visualize功能完整的任务跟踪器支持依赖关系与可视化read_mcp_resource、list_mcp_resources访问 MCP 资源这些工具对运行 superpowers 工作流有直接意义enter_plan_mode/exit_plan_mode对应writing-plans、executing-plans等流程技能对只读规划阶段的要求ask_user对应技能里向人类伙伴提问澄清的动作tracker 系列则提供了比write_todos更强的任务依赖管理——与subagent-driven-development中账本 待办的双轨记账模式互补read_mcp_resource/list_mcp_resources让使用 mcp-builder skill 构建的 MCP 服务器成果可以被 Gemini CLI 会话直接消费。六、在 superpowers-zh 中的实际落地整套映射并非孤立文档而是 superpowers-zh 平台适配体系的一环。在 using-superpowers/SKILL.md 的平台适配一节中明确写道Gemini CLI 用户通过GEMINI.md自动获得references/gemini-tools.md的工具映射——也就是说只要你的项目根目录GEMINI.md里像本仓库那样导入了该参考文件Gemini CLI 会话启动时就已具备全套映射无需手工记忆。具体落地步骤总结如下安装按 docs/README.gemini-cli.md 用npx superpowers-zh自动安装或手动把skills/复制到.gemini/skills/项目级或~/.gemini/extensions/superpowers-zh/skills/全局扩展级。引用在项目GEMINI.md中用./skills/using-superpowers/SKILL.md与./skills/using-superpowers/references/gemini-tools.md导入技能框架与工具映射并按需写入遇到新功能开发时先使用 brainstorming skill、写代码时遵循 test-driven-development skill这类工作方法论。执行会话中skill 里的读文件 / 建待办 / 分派子智能体分别落到read_file、write_todos、invoke_agent或generalist上涉及模板引用的分派先读模板、填占位符、再交给generalist独立任务在同一条响应中并行invoke_agent。排障skills 不生效时依次核对.gemini/skills/目录结构、SKILL.md的 frontmatter 有效性、gemini-extension.json是否位于~/.gemini/extensions/superpowers-zh/最后重启 Gemini CLI。至此从动作到工具、从指令文件到子智能体分派、从独有工具到安装排障Gemini CLI 上的 superpowers 完整运行链路已然打通——剩下的就是把using-superpowers的红线任何响应之前先检查 skill真正变成日常习惯。赞分享AI 技能AI 插件人工智能开发工具【免费下载链接】superpowers-zh AI 编程超能力 · 中文增强版 — superpowers250k ⭐完整汉化 4 个中国原创 skills让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 26 款 AI 编程工具真正会干活项目地址https://gitcode.com/gh_mirrors/su/superpowers-zh点击查看免费下载相关推荐Gemini CLI SDK 实战指南用 google/gemini-cli-sdk 在 Node.js 中构建可编程的 Gemini AgentGemini CLI SDK 实战指南用 google/gemini cli sdk 在 Node.js 中构建可编程的 Gemini Agent 本篇指南人工智能AI Agent交互助手CLIMCP Clientssuperpowers-zh 的 Copilot CLI 工具映射实战指南在 GitHub Copilot 上运行 AI 编程 Skillssuperpowers zh 的 Copilot CLI 工具映射实战指南在 GitHub Copilot 上运行 AI 编程 Skills superpowAI 技能AI 插件人工智能开发工具在 Gemini CLI 中启用 superpowers-zh 技能框架GEMINI.md 引导、20 个 Skills 与工具映射实战指南在 Gemini CLI 中启用 superpowers zh 技能框架GEMINI.md 引导、20 个 Skills 与工具映射实战指南 本文是 supeAI 技能AI 插件人工智能开发工具上一篇Switch大气层系统终极配置指南5分钟解决破解难题与性能调优下一篇VimWiki安装完全指南5种方式对比Vim-Plug/Vundle/Pathogen/Packages/手动哪种最适合你创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考