在 Gemini CLI 中启用 superpowers-zh 技能框架：GEMINI.md 引导、20 个 Skills 与工具映射实战指南

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-zh 在 Gemini CLI 中的落地指南以仓库根目录的 GEMINI.md 为入口讲解这套 20 个 skills 的 AI 编程方法论如何被 Gemini CLI 识别、加载与调用并给出 skill 动作到invoke_agent、write_todos等具体工具的映射关系。读完本文你将掌握 Gemini CLI 下的技能路由规则、工具调用清单以及从头脑风暴到代码审查的完整实战路径。GEMINI.md 是什么Gemini CLI 的技能引导文件在 superpowers-zh 中GEMINI.md是 Gemini CLI 的引导文件bootstrap它让 AI 在会话开始时就知道仓库里装了一套技能框架、有哪些技能、按什么规则触发。文件开头通过两行引用把最核心的两份材料锚进上下文./skills/using-superpowers/SKILL.md ./skills/using-superpowers/references/gemini-tools.mdskills/using-superpowers/SKILL.md元技能确立如何查找和使用技能的整体规则skills/using-superpowers/references/gemini-tools.mdGemini CLI 专属的动作 → 工具映射表。这两份文件对应仓库内的实际路径为 skills/using-superpowers/SKILL.md 与 skills/using-superpowers/references/gemini-tools.md。为什么是 GEMINI.md扩展清单里的 contextFileNameGemini CLI 是按层级加载GEMINI.md的全局的在~/.gemini/GEMINI.md项目级的在工作区目录及其各级父目录里另外当某个工具访问子目录中的文件时该子目录下的GEMINI.md也会被加载。本项目以 Gemini 扩展extension形式发布时由 gemini-extension.json 显式声明引导文件{ name: superpowers-zh, description: AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论, version: 1.7.13, contextFileName: GEMINI.md }contextFileName指向GEMINI.md意味着扩展装载后Gemini CLI 会在每个会话自动加载这份引导文件——这正是skill 在恰当时机自动触发的关键。CLAUDE.md 中有一段同样的论断可作旁证bootstrap 是让 skill 在恰当时机自动触发的关键。没有它skill 就是死重——文件在磁盘上但永远不会被调用。见 CLAUDE.md核心规则四条铁律GEMINI.md 明确列出四条贯穿所有技能的核心规则它们是整个方法论的总纲收到任务时先检查是否有匹配的 skill— 哪怕只有 1% 的可能性也要检查设计先于编码— 收到功能需求时先用 brainstorming skill 做需求分析测试先于实现— 写代码前先写测试TDD验证先于完成— 声称完成前必须运行验证命令。这四条规则与 skills/using-superpowers/SKILL.md 中的规则一一呼应。特别是第 1 条在该元技能中上升为一条不可协商的硬约束如果你认为哪怕只有 1% 的可能性某个技能适用于你正在做的事情你绝对必须调用该技能。如果一个技能适用于你的任务你没有选择。你必须使用它。这不可协商。你不能通过合理化来逃避。并且要求在任何响应或操作之前调用相关或被请求的技能——包括澄清性问题、探索代码库、查看文件之前。技能路由using-superpowers 元技能怎么调度using-superpowers是本项目技能体系中的元技能meta-skill它规定其他技能如何被挑选、排序与触发详见 skills/using-superpowers/SKILL.md。技能优先级当多个技能都适用时流程技能优先——它们决定处理方式然后由实现技能负责执行让我们构建 X → 先用brainstorming再用实现技能修复这个 bug → 先用systematic-debugging再用领域技能。头脑风暴和系统化调试是 Superpowers 中最常见的流程技能但这条规则适用于任何流程技能。红线识别合理化话术元技能提供了一张红线对照表这些想法意味着 AI 正在为自己不查技能找借口想法现实这只是一个简单的问题问题就是任务。检查技能。我需要先了解更多上下文技能检查在澄清性问题之前。让我先探索一下代码库技能告诉你如何探索。先检查。我可以快速查一下 git/文件文件缺少对话上下文。检查技能。让我先收集信息技能告诉你如何收集信息。这不需要正式的技能如果技能存在就使用它。我记得这个技能技能会迭代更新。阅读当前版本。这不算一个任务行动 任务。检查技能。技能太小题大做了简单的事会变复杂。使用它。让我先做这一件事在做任何事之前先检查。这样做感觉很高效无纪律的行动浪费时间。技能防止这一点。我知道那是什么意思知道概念 ≠ 使用技能。调用它。指令优先级与平台适配用户指令CLAUDE.md、AGENTS.md、GEMINI.md等、直接请求优先于技能技能又优先于默认行为只有人类伙伴明确要求跳过时才能跳过技能工作流。元技能还按运行环境做平台适配Codex、Pi、Antigravity、Copilot CLI、Hermes Agent、Qoder 各自读取对应的references/*-tools.md。Gemini CLI 用户则通过GEMINI.md自动获得 skills/using-superpowers/references/gemini-tools.md 的工具映射无需额外配置。可用 20 个 Skills 全景Skills 位于.gemini/skills/目录安装时由安装器复制到该位置每个 skill 有独立的SKILL.md文件内含name和description的 YAML frontmatter。GEMINI.md 列出的全部 20 个技能及其触发时机如下设计规划类Skill触发时机brainstorming在任何创造性工作之前必须使用——创建功能、构建组件、添加功能或修改行为。在实现之前先探索用户意图、需求和设计。实现见 skills/brainstorming/SKILL.mdwriting-plans当你有规格说明或需求用于多步骤任务时使用在动手写代码之前executing-plans当你有一份书面实现计划需要在单独的会话中执行并设有审查检查点时使用开发流程类Skill触发时机test-driven-development在实现任何功能或修复 bug 时使用在编写实现代码之前。实现见 skills/test-driven-development/SKILL.mdsystematic-debugging遇到任何 bug、测试失败或异常行为时使用在提出修复方案之前执行。实现见 skills/systematic-debugging/SKILL.mdsubagent-driven-development当在当前会话中执行包含独立任务的实现计划时使用dispatching-parallel-agents当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用using-git-worktrees当需要开始与当前工作区隔离的功能开发或执行实现计划之前使用——创建具有智能目录选择和安全验证的隔离 git 工作树finishing-a-development-branch当实现完成、所有测试通过、需要决定如何集成工作时使用——通过提供合并、PR 或清理等结构化选项来引导开发工作的收尾代码质量类Skill触发时机requesting-code-review完成任务、实现重要功能或合并前使用用于验证工作成果是否符合要求receiving-code-review收到代码审查反馈后、实施建议之前使用尤其当反馈不明确或技术上有疑问时——需要技术严谨性和验证而非敷衍附和或盲目执行verification-before-completion在宣称工作完成、已修复或测试通过之前使用在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功始终用证据支撑断言协作与扩展类Skill触发时机mcp-builderMCP 服务器构建方法论——系统化构建生产级 MCP 工具让 AI 助手连接外部能力workflow-runner在 Claude Code / OpenClaw / Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发writing-skills当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用using-superpowers在开始任何对话时使用——确立如何查找和使用技能要求在任何响应包括澄清性问题之前调用 Skill 工具中国原创技能仅在显式调用时加载Skill触发时机chinese-code-review中文 review 沟通参考——话术模板、分级标注必须修复/建议修改/仅供参考、国内团队常见反模式应对。仅在用户显式/chinese-code-review时调用chinese-commit-conventions中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog 中文配置。仅在用户显式/chinese-commit-conventions时调用chinese-documentation中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式/chinese-documentation时调用chinese-git-workflow国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式/chinese-git-workflow时调用中国特色技能路由4 个 chinese-* 为什么只手动skills/using-superpowers/SKILL.md 中有一节标注为superpowers-zh 的增量内容上游 obra/superpowers 没有的中国特色技能路由其设计决策值得单独说明这 4 个 chinese-* 是参考资料不是工作流——话术模板、排版约定、平台配置差异。它们只在用户显式调用时才加载不要根据上下文自动触发上下文里多一份排版参考不会让你写得更好只会挤掉真正需要的内容。路由表如下用户显式说加载技能里面是什么/chinese-code-reviewchinese-code-review中文 review 话术模板、分级标注、国内团队常见反模式应对/chinese-git-workflowchinese-git-workflowGitee / Coding.net / 极狐 GitLab / CNB 的 SSH、凭据、CI 接入差异/chinese-documentationchinese-documentation中英文空格、全半角标点、术语保留、中文文案排版指北约定/chinese-commit-conventionschinese-commit-conventionsConventional Commits 中文适配、commitlint / husky 中文模板两个要点其一用户没点名就不要主动拉进来点名了就照它执行不要因为看起来只是格式问题而跳过。其二它们与翻译技能叠加使用、不互斥——用户要求做中文 review 时是requesting-code-review流程加上chinese-code-review风格不是二选一。该节还注明只在显式调用时加载是刻意决定见 commit392ff75改动需要 eval 证据。Gemini CLI 工具映射Skill 动作 → 具体工具Skills 里说的是动作分派一个子智能体、建一条待办、读一个文件Gemini CLI 上对应哪些工具skills/using-superpowers/references/gemini-tools.md 给出完整映射表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个人 skills 目录的两种位置Gemini CLI 的用户级 skills 放在~/.gemini/skills/~/.agents/skills/是跨运行时的别名目录与 Codex、Copilot CLI 共用。当同一层级下两个目录都存在时.agents/skills/优先。每个 skill 是一个子目录里面有一份带name和descriptionfrontmatter 的SKILL.md。子智能体支持invoke_agent 与 generalistGemini CLI 通过invoke_agent工具分派子智能体接收agent_name和prompt两个参数。聊天语法快捷方式输入generalist prompt等价于以agent_name: generalist调用invoke_agent。内置 agent 名包括generalist、cli_help、codebase_investigator以及启用浏览器工具后的browser_agent。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填写提示词时模板里的{WHAT_WAS_IMPLEMENTED}、[FULL TEXT of task]等占位符必须全部填好再把完整提示词交给invoke_agent——模板本身就包含了该 agent 的角色、审查标准和期望的输出格式。并行分派方面Gemini CLI 支持在同一条响应里发出多个invoke_agent调用或在一个提示词里写多个generalist让相互独立的子智能体并行跑有依赖关系的任务保持串行但不要为了让历史记录简单一点就把相互独立的子智能体任务串起来。Gemini CLI 额外工具以下工具为 Gemini 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 资源安装与启用让 GEMINI.md 生效完整的安装说明见 docs/README.gemini-cli.md这里给出与 GEMINI.md 直接相关的三条路径。自动安装推荐cd /your/project npx superpowers-zh安装脚本会自动检测.gemini/目录并将 skills 复制到.gemini/skills/目录。这与 README 中 Gemini CLI 的说明一致npx superpowers-zh即一键安装到.gemini/skills/见 README.md。手动安装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/Skill 加载优先级位置优先级说明.gemini/skills/最高项目级仅当前项目~/.gemini/extensions/*/skills/中扩展级所有项目共享故障排查Skills 未生效确认.gemini/skills/目录存在且包含 skill 文件夹每个 skill 需要包含带有效 YAML frontmatter 的SKILL.md文件重启 Gemini CLI。扩展模式未加载检查gemini-extension.json是否正确放在扩展目录中确认扩展目录结构为~/.gemini/extensions/superpowers-zh/。实战闭环GEMINI.md 引导下的一次完整开发将 GEMINI.md 的核心规则与 20 个技能串联起来在 Gemini CLI 中一次典型的功能开发会走这样一条路径技能检查收到任务后using-superpowers元技能要求先调用activate_skill检查是否有匹配技能头脑风暴功能需求先走brainstorming在实现前探索用户意图与需求。该技能内部有探路Spike/有界Bounded/架构级Architectural三条路径且设置了HARD-GATE——在人类伙伴批准之前不调用任何实现技能、不写任何代码见 skills/brainstorming/SKILL.md编写计划架构级任务在脑暴通过后调用writing-plans把规格拆成可执行步骤测试驱动开发写代码前先写失败测试红-绿-重构循环。铁律是没有失败的测试就不写生产代码见 skills/test-driven-development/SKILL.md系统化调试遇到 bug 先做根因调查再提修复不做根因调查不许提修复方案见 skills/systematic-debugging/SKILL.md请求代码审查任务完成、合并前用requesting-code-review派遣审查 agent 验证成果完成前验证声称完成前必须运行验证命令并确认输出始终用证据支撑断言。整个流程中Gemini CLI 侧的write_todos负责任务跟踪invoke_agent负责分派审查与实现子智能体——这正是 GEMINI.md 里设计先于编码、测试先于实现、验证先于完成三条规则在工具层的落地。小结GEMINI.md是 superpowers-zh 在 Gemini CLI 中的一切起点它通过两行引用把using-superpowers元技能和gemini-tools.md工具映射锚进每个会话用四条核心规则约束 AI 的行为用 20 个技能覆盖从头脑风暴到代码审查的完整开发闭环。安装后你只需在 Gemini CLI 中正常对话技能就会在恰当时机被自动触发配合 skills/using-superpowers/references/gemini-tools.md 的映射表你可以随时把技能里的每个动作翻译成具体的 Gemini CLI 工具调用实现完全可控的 AI 编程工作流。赞分享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点击查看免费下载相关推荐「Tool Router」实战按用户隔离 MCP 会话「Tool Router」实战按用户隔离 MCP 会话 客服助手里一个模型服务所有用户工具列表是共用的一张大表。A 用户问帮我看看最近的邮件模型可能人工智能AI Agent工具调用MCP 服务MCP Clients在 Gemini CLI 中启用 Agentic Awesome Skills安装、验证与提示词实战指南在 Gemini CLI 中启用 Agentic Awesome Skills安装、验证与提示词实战指南 Agentic Awesome SkillsAASAI 技能AI 插件agent-skills 与 Superpowers、Pocock skills 怎么选按工作形态选技能框架agent skills 与 Superpowers、Pocock skills 怎么选按工作形态选技能框架 如果你正在给 AI 编码代理挑选一套技能sAI 技能开发工具AI 评测Benchmark上一篇10个简单方法检查Linux系统NTP时间同步状态终极指南下一篇10分钟上手gin-vue-admin实时通信WebSocket实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考