名称: gemini-extension-development 描述: 构建和管理Gemini CLI扩展的专家指南。涵盖扩展结构、GEMINI.md上下文、命令、MCP集成和发布。适用于创建Gemini扩展、链接本地扩展、打包MCP服务器或从GitHub安装扩展。委托给gemini-cli-docs。 允许工具: 读取、全局搜索、grep、技能
Gemini扩展开发
文档委托
文档来源: 关于权威的扩展语法和当前功能,请查询
gemini-cli-docs技能。 本技能提供开发指导;gemini-cli-docs提供官方Gemini CLI文档。
概述
创建、测试和分发Gemini CLI扩展的专家技能。扩展是Gemini的主要插件机制。
何时使用此技能
关键词: gemini扩展、创建扩展、gemini扩展链接、扩展画廊、上下文文件、扩展命令、扩展发布、卸载扩展
在以下情况使用此技能:
- 创建新扩展(
gemini extensions create) - 链接本地扩展以进行开发(
gemini extensions link) - 将MCP服务器打包到扩展中
- 向扩展添加自定义斜杠命令(
.toml) - 从GitHub或本地路径安装扩展
- 通过Git或GitHub发布扩展
扩展结构
扩展可以包含:
extension.yaml: 清单文件。GEMINI.md: 模型的上下文“操作指南”。package.json: 依赖项(如果使用Node.js/TypeScript)。注意: 使用统一的Google Gen AI SDK(例如google-genai),因为google-generativeai已弃用。- MCP服务器: 嵌入式工具。
- 命令: 定义自定义斜杠命令的
*.toml文件。 - 工具限制:
excludeTools配置。
开发工作流
- 创建:
gemini extensions create my-extension - 链接:
cd my-extension && gemini extensions link .(启用热重载) - 测试: 运行
gemini并使用新功能。 - 发布: 推送到GitHub(可通过URL安装)。
关键词注册(委托给gemini-cli-docs)
| 主题 | 查询关键词 |
|---|---|
| 创建 | create extension, extension template |
| 清单 | extension.yaml schema, extension manifest |
| 命令 | extension slash commands, toml commands |
| 链接 | gemini extensions link, local extension dev |
| 发布 | extension releasing git, github release extension |
| 管理 | uninstall extension, update extension |
快速决策树
你想做什么?
- 开始一个新扩展 -> 查询
gemini-cli-docs:“create extension boilerplate” - 本地测试 -> 查询
gemini-cli-docs:“link local extension” - 添加命令 -> 查询
gemini-cli-docs:“define command in extension” - 捆绑MCP服务器 -> 查询
gemini-cli-docs:“extension mcp server” - 安装扩展 -> 查询
gemini-cli-docs:“install extension from url” - 发布扩展 -> 查询
gemini-cli-docs:“extension releasing git vs github”
测试场景
场景1:创建扩展
查询: “如何创建新的Gemini CLI扩展?” 预期行为:
- 技能在"create extension"上激活
- 委托给gemini-cli-docs获取模板命令
成功标准: 用户收到
gemini extensions create语法
场景2:开发链接
查询: “如何在本地测试我的Gemini扩展?” 预期行为:
- 技能在"test extension"或"link extension"上激活
- 提供
gemini extensions link .工作流 成功标准: 用户收到本地开发工作流
场景3:发布扩展
查询: “如何发布我的Gemini扩展?” 预期行为:
- 技能在"release extension"或"publish"上激活
- 委托给文档获取Git/GitHub发布选项 成功标准: 用户收到发布工作流选项
参考文献
官方文档:
查询gemini-cli-docs获取:
- “extensions”
- “extension development”
版本历史
- v1.1.0 (2025-12-01): 添加测试场景部分
- v1.0.0 (2025-11-25): 初始发布