企业官网建设流程全解析

• AI 技能
• AI 插件
• 人工智能
• 开发工具

导读

本文是 superpowers-zh（AI 编程超能力中文增强版）为 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 会话。

这份映射的实践意义在于：任何一个 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 与 @generalist

Gemini 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 上的等价做法如下：

以仓库实际模板为例：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_SHA（git 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）的映射表中没有对应物：

这些工具对运行 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 会话启动时就已具备全套映射，无需手工记忆。

具体落地步骤总结如下：

1. 安装：按 docs/README.gemini-cli.md 用npx superpowers-zh自动安装，或手动把skills/复制到.gemini/skills/（项目级）或~/.gemini/extensions/superpowers-zh/skills/（全局扩展级）。
2. 引用：在项目GEMINI.md中用@./skills/using-superpowers/SKILL.md与@./skills/using-superpowers/references/gemini-tools.md导入技能框架与工具映射，并按需写入"遇到新功能开发时先使用 brainstorming skill、写代码时遵循 test-driven-development skill"这类工作方法论。
3. 执行：会话中，skill 里的"读文件 / 建待办 / 分派子智能体"分别落到read_file、write_todos、invoke_agent（或@generalist）上；涉及模板引用的分派，先读模板、填占位符、再交给generalist；独立任务在同一条响应中并行invoke_agent。
4. 排障：skills 不生效时依次核对.gemini/skills/目录结构、SKILL.md的 frontmatter 有效性、gemini-extension.json是否位于~/.gemini/extensions/superpowers-zh/，最后重启 Gemini CLI。

至此，从动作到工具、从指令文件到子智能体分派、从独有工具到安装排障，Gemini CLI 上的 superpowers 完整运行链路已然打通——剩下的就是把using-superpowers的红线（"任何响应之前先检查 skill"）真正变成日常习惯。

• AI 技能
• AI 插件
• 人工智能
• 开发工具