Gemini Skills 怎么用、怎么写:技能的命名、描述与指令写法(官方最佳实践)

Gemini 的技能(Skills)建起来容易,写得让它「该用的时候会用、用了就按你的方式做」才是难点。本文按官方《Write effective skills》整理:什么时候该建技能、名称和描述怎么写、指令怎么控制松紧、模板、清单、常见错误和缺信息时的处理,并附一个完整示例。

NNathaniel bigo··原创首发·AI 辅助撰写
9 分钟读完
资料核对于 2026-10-10 · 依据官方文档与公开资料整理 免费账号 账号
本文根据 Google 官方 Gemini 帮助中心整理,核对日期 2026-10-10。技能的入口、Gems 迁移时间表和文件限制,本站《Gemini 使用技巧:Gems 改为 Skills、Deep Research 与上传文件怎么用》已有介绍;本文专讲怎么把技能写好。文中的技能示例为本站按官方规则编写,仅供参考。

适用于谁

  • 搜「gemini 怎么用 skill」「gemini skills 如何使用」「gemini skills 教学」的人;
  • 已经建过技能,但发现 Gemini 不调用它,或调用了也不按要求做的人;
  • 准备把常用提示词、原来的 Gems 改造成技能的人。

结论先说

  1. 技能是「小抄」,不是「手册」:一个技能只管一类事,写清步骤、格式规则和常见错误,越短越聚焦越好。
  2. 名称和描述决定它会不会被用:Gemini 判断是否调用时,只看名称和 1~2 句描述;描述写得笼统,它就想不起来用。
  3. 描述的官方句式:第三人称说明它能做什么,再接一句「Use when…(在……时使用)」列出具体场景;上限 1024 个字符。
  4. 指令的松紧要匹配任务:创意类少管,数据和格式类写成一步步的硬规定。
  5. 四个提分项:给输出模板、列「常见错误」、长流程给清单、写明缺信息时怎么办。
  6. 使用条件:年满 18 岁、个人 Google 账号、开启「保留活动记录」;不需要订阅。

一、先判断:这件事值不值得建技能

官方给的判断标准——

适合建技能:

  • 重复的提示词:同一套要求你一遍遍地打,尤其是又长又复杂的;
  • 反复改格式:每次都要让它把版式、风格调成你要的样子;
  • 跨应用拼步骤:需要在 Gmail、文档、日历之间手动接力。

不必建技能:

  • 一次性的事;
  • Gemini 本来就做得好,不给额外指导结果也符合预期;
  • 规则老在变,技能更新跟不上。

二、技能是怎么被调用的

为了保持速度,Gemini 不会一上来就把所有技能读一遍,而是分三步:

  1. 判断相关性:只看每个技能的名称和描述;
  2. 读取并执行:认为相关,才去读完整指令;
  3. 按需打开文件:技能里带的模板、风格指南、表格等参考文件,用到时才打开。

这解释了两件事:为什么名称和描述最关键;以及为什么可以放心把细节放进参考文件——不用的时候它不占地方。

调用方式有两种:在对话或任务里输入 /(更新后为 @)手动选;或者让已启用的技能在相关时被自动使用。一个任务可以叠加多个技能,技能的指令里也可以引用其他技能。

三、写好名称

规则说明
用动词开头说它「做什么」,而不是它「是什么」
避开空泛的词比如 helper、tools、data
遵守格式全小写,单词之间用连字符,例如 my-new-skill

官方示例:用 plan-meal-from-recipe,不要用 recipe-data。

四、写好描述

三条规则:

  1. 以第三人称的能力陈述开头:写「它做什么」,不要写「我可以帮你……」或「你可以用它来……」;
  2. 列出具体的使用场景:用「Use when…」起句,告诉 Gemini 什么情况下该用;
  3. 保持聚焦,不超过 1024 个字符。

官方示例(原文为英文):

Categorizes recipes, scales ingredient portions, and generates grocery lists from selected meals. Use when saving a new recipe, adjusting the serving size for a meal, or creating a shopping list from a meal plan.

对应到中文可以写成:「对菜谱分类、按人数换算食材用量,并根据选定的菜单生成采购清单。在保存新菜谱、调整某顿饭的份量、或根据一周菜单列购物清单时使用。」

五、写好指令

1. 教「一类任务」,不是「一个任务」

  • 不好:只对一个结果有效,比如「给周二的意大利面列采购清单」;
  • 好:说明如何根据你的口味生成任何一份菜单和清单。

2. 决定管多严

任务类型写法例子
创意类,答案不唯一给方向即可,留出发挥空间想博客选题、写社交媒体标题
严格 / 关键类,错一点就算错写清楚每一步,要求严格照做按固定版式誊抄财务数据、只用要点列表总结会议纪要

3. 给出格式和输出模板。官方示例:

客户报告一律包含以下部分:「执行摘要」「主要发现」「建议」「下一步」。
写社交媒体帖子时使用这个模板:
标题:[标题]
正文:[正文]
话题标签:#[标签1] #[标签2] #[标签3]

4. 加一节「常见错误」。例如:

  • 删除个人信息:除非任务明确要求,报告里不要出现姓名、邮箱、电话;
  • 免责声明用公司模板里的标准版本,不要自己另写。

5. 长流程给清单,让它边做边勾,避免漏步骤:

复制这份清单并跟踪进度:
[ ] 第 1 步:分析上传的银行对账单
[ ] 第 2 步:提取每笔交易的日期、摘要和金额
[ ] 第 3 步:给每笔交易分类
[ ] 第 4 步:整理成表格

6. 写明缺信息时怎么办,防止它编造或跳过:

  • 「如果邮件里没有活动日期,问我要,不要猜,也不要省略。」
  • 「表单里有空着的字段时,停下来让我补,不要自己编答案。」

六、一个完整示例

按上面的规则,把「周报」写成技能(本站示例):

  • 名称:write-weekly-report-from-notes
  • 描述:把零散的工作记录整理成固定结构的周报。在用户提供本周工作笔记、聊天记录或任务清单并要求写周报、周总结时使用。
  • 指令:
## 步骤
[ ] 1. 通读用户提供的全部材料,按项目归类。
[ ] 2. 每个项目提取:本周完成、进行中、受阻事项。
[ ] 3. 按下面的模板输出。

## 输出模板
### 本周完成
- [项目名]:[结果,尽量带数字]
### 进行中
- [项目名]:[当前进度] → [预计完成时间]
### 风险与需要的支持
- [问题]:[需要谁做什么]
### 下周计划
- [事项]

## 常见错误
- 不要把「开了会」「在跟进」当成果,写不出结果的放进「进行中」。
- 不要补充材料里没有的数字。
- 全文不超过 400 字,不写开场白和结束语。

## 缺信息时
- 没有提到完成时间的进行中事项,标注「时间待确认」并在最后列出来问我。

这个例子对应了官方的每一条建议:动词开头的名称、带使用场景的描述、清单、模板、常见错误、缺信息处理。

七、创建、测试与维护

创建入口在网页版(或 Mac 版)侧边栏「设置 → 技能(Skills)」,可以让 Gemini 陪你创建、改推荐模板、手动填写,或上传 SKILL.md 文件 / 含 SKILL.md 的文件夹和 .zip。也可以在任意对话里说「根据以下要求创建一个技能:……」。

几条维护要点(操作入口来自帮助中心,测试方法是本站的建议):

  • 测试自动调用:开一个新对话,不点名技能,直接说一个它应该处理的需求,看它用没用。没用上,多半是描述里的场景不够具体,回去改「Use when…」;
  • 停用而不删除:技能页点开技能 →「更多 → 停用(Deactivate)」,Gemini 就不会再自动使用它;手动点名时会问你要不要重新启用;
  • 编辑:直接改描述和指令;或「更多 → 让 Gemini 帮忙编辑」;要更新参考文件,必须把整个技能连同文件重新上传(「更多 → 替换技能」);
  • 下载备份:「更多 → 下载」得到一个 .zip。想自己手写 SKILL.md,最稳妥的办法是先在页面上建一个,下载下来照着官方生成的结构改;
  • 删除不可撤销,而且只能在技能页删,不能在对话里删。

上传文件的硬限制:只支持纯文本类文件(.txt、.md、.csv、.json、.py 等)以及 PDF 和图片,不支持 .docx、.xlsx;总大小不超过 100 MB;脚本不能访问外部网站。上传前检查文件夹里有没有 .DS_Store、.pyc 这类隐藏的二进制文件,它们可能导致上传失败。

常见问题

Q:技能和「给 Gemini 的指令」有什么区别?

固定指令对每一个对话都生效,适合「永远用中文回答」这类全局偏好;技能只在相关任务里被调用,适合某一类具体工作。

Q:技能要付费吗?

帮助中心明确写:技能不需要 Google AI 订阅,可以在普通对话里使用。需要订阅的是 Gemini Spark 的任务和日程。

Q:我的 Gems 怎么办?

Gems 下线时会被自动重建为技能;想提前迁移,可以手动重建,步骤见本站《Gemini 使用技巧:Gems 改为 Skills、Deep Research 与上传文件怎么用》。

Q:Gemini 的 SKILL.md 和 Claude、Codex 的技能通用吗?

Gemini 帮助中心明确写:可以把在其他平台创建的技能,通过上传它们的 SKILL.md 文件导入进来(上传入口目前仅网页版和 Mac 版)。不过各家支持的能力不完全相同——比如 Gemini 的技能脚本不能访问外部网站,参考文件也不支持 .docx、.xlsx——导入后要实际跑一遍。另见本站《Claude Skills 是什么、怎么装、推荐哪些》《ChatGPT Skills 怎么用:创建、@调用与推荐(附哪些套餐能用)》。

参考资料

  • Write effective skills for Gemini Apps(Gemini 帮助中心):https://support.google.com/gemini/answer/17102773
  • Create & manage skills for Gemini Apps:https://support.google.com/gemini/answer/17094296
  • About the transition from Gems to skills:https://support.google.com/gemini/answer/18560919
  • Use Gemini Spark to manage your tasks & workflows in Gemini Apps:https://support.google.com/gemini/answer/17094507

Nathaniel 的更多内容

  1. 01

    promptfoo 使用教程:对比提示词和模型、写断言自动评测(安装与配置)

    promptfoo 是什么、怎么使用?按官方 README 和入门文档讲清它的用途、三种安装方式、用示例项目起步、promptfooconfig.yaml 里提示词、模型和测试用例三部分怎么写、常用断言类型的含义、eval 与 view 两条命令,以及把它放进日常改提示词流程的方法。

    ChatGPT其他 AI 工具0
  2. 02

    Kimi API怎么用:API Key获取、Python调用、K3价格与429报错处理

    Kimi API Key 在哪里获取、怎么用 Python 调用 K3、价格怎么算、429 和 401 报错怎么办?本文按 Kimi API 开放平台官方文档讲清注册认证、创建 Key、base_url 与模型名、计费规则和常见错误排查。

    Kimi0
  3. 03

    Cursor Agent 模式怎么用:Agent、Plan、Ask 三种模式,检查点回滚与消息排队

    Cursor Agent 模式是什么、和 Plan / Ask 模式怎么选?按官方文档讲清 Agent 能调用哪些工具、Shift+Tab 切换模式、Plan 模式先出方案再动手、用检查点撤销改动、任务进行中排队或插话,以及 /goal 长目标。

    Cursor0
  4. 04

    Gemini 聊天记录怎么导出:导出到文档 / 表格、生成 PDF 与用 Takeout 批量导出完整对话

    Gemini 没有「一键导出全部对话」的按钮,但有三条官方路径:单条回答导出到 Google 文档、Gmail、表格;让 Gemini 直接生成 PDF、Word、Markdown 文件;用 Google Takeout 批量下载全部活动记录。本文给出每种方法的步骤和限制。

    Gemini0
  5. 05

    ChatGPT 生成图片中文乱码、文字错误怎么办:7 个按顺序试的办法

    让 ChatGPT 做海报、封面、信息图,中文总是缺笔画、错字、乱码?本文按 OpenAI 官方图像提示指南,给出从写法、字数、局部修改、质量档位到后期排版的 7 个办法,以及什么时候干脆别让 AI 写字。

    ChatGPT0
  6. 06

    OpenCode Skills 使用指南:技能目录、命名规则、权限配置与不加载排查

    OpenCode 的 Skills 放在哪个目录、怎么控制哪些技能能用?按 OpenCode 官方文档讲清六个扫描位置、name 的正则规则、skill 工具的工作方式、在 opencode.json 里用 allow / deny / ask 配置权限、按智能体覆盖,以及技能不出现时的五项检查。

    其他 AI 工具0

同模型

  1. 01

    Gemini API Node.js / JavaScript 调用教程:@google/genai 安装、流式输出与函数调用

    用官方 @google/genai SDK 在 Node.js 里调 Gemini API:安装配置、第一个请求、流式输出、多轮对话、传图片和函数调用的完整循环,并说明为什么密钥不能写进浏览器前端。

    Gemini0
  2. 02

    Google AI Studio 系统指令怎么写:System instructions 与运行设置(思考等级、温度、联网搜索)

    系统指令决定模型的身份和输出规则。本文按官方文档讲清 AI Studio 里系统指令在哪填、怎么写、怎么保存复用,以及思考等级、温度(新模型已弃用)、联网搜索等工具的作用与限制。

    Gemini0
  3. 03

    Gemini 结构化输出(Structured Output)怎么用:JSON Schema、Pydantic 与 Zod 示例

    想让 Gemini API 稳定返回可解析的 JSON,就用结构化输出。本文给出 Pydantic 和 Zod 的官方写法、枚举与可空字段、流式、和工具组合、支持的 Schema 范围与限制,以及新旧接口的参数差别。

    Gemini0
  4. 04

    Gemini API 接口地址(Base URL)是什么:原生端点与 OpenAI 兼容调用写法

    Gemini API 域名是 generativelanguage.googleapis.com。本文列出原生与 OpenAI 兼容端点的地址和鉴权方式、v1 与 v1beta 的区别,和用 OpenAI SDK 调 Gemini 的写法。

    Gemini0
  5. 05

    Gemini 怎么看额度:用量限制在哪查、多久重置、额度变少怎么办

    Gemini 的额度不是按条数算的,而是按计算量:每 5 小时刷新、另有每周上限。本文讲在哪里查看用量、各档会员的额度倍数、哪些操作最费额度、额度用完后会怎样,以及官方认可的省额度方法。

    Gemini0
  6. 06

    Gemini Canvas 怎么用:写文档、生成网页和小应用、导出与分享全流程

    Gemini Canvas 是对话旁边的一块可编辑工作区:在里面写文档、做幻灯片、生成能直接运行的网页和小应用。本文按官方帮助中心讲入口、文档的局部修改与格式工具、应用的预览 / 代码 / 控制台、把文档变成测验 / 信息图 / 网页,以及导出和分享的方法与限制。

    Gemini0

同产品的其他教程

  1. 01

    提示词链(Prompt Chaining)怎么用:把复杂任务拆成几步,前一步的输出交给后一步

    提示词链是什么、什么时候该把大提示词拆开?本文按 Anthropic 和 Google 官方文档讲清拆指令、串成链、分块聚合三种拆法,最常用的「起草 → 审查 → 修改」链,以及哪些情况不必拆。

    ClaudeGemini0
  2. 02

    Nano Banana 提示词怎么写:官方提示词指南要点与 7 个生成模板

    Nano Banana(Gemini 生图)的提示词怎么写效果最好?本文把 Google 官方提示词指南提炼成 6 条原则和写实照片、贴纸、带文字设计、商品图、留白背景、漫画分镜、搜索增强 7 个可复制模板,并给出改图句式。

    Gemini0
  3. 03

    NotebookLM PPT 可编辑吗:演示文稿的生成、修改、下载 PPTX 与信息图

    NotebookLM(现名 Gemini Notebook)生成的 PPT 能改吗、怎么下载?本文按官方帮助讲清演示文稿的两种格式、用「修改(Revise)」逐页改稿、删页和调整顺序、下载 PDF 或 PPTX,以及信息图的风格和下载。

    Gemini0
  4. 04

    Gemini 音乐生成怎么用:用 Lyria 写歌作曲、歌曲长度、下载 MP3 与水印说明

    Gemini 里可以直接用 Lyria 模型生成带人声和歌词的完整歌曲。本文按官方帮助中心讲入口、使用条件、短曲与完整曲目的长度、人声 / 纯音乐与曲风选项、提示词五要素、下载 MP3 / MP4 和分享、SynthID 水印,以及次数限制该怎么看。

    Gemini0
  5. 05

    Veo 3.1 提示词怎么写:主体、动作、镜头、声音与对白的官方写法

    Veo 3.1 和 Gemini Omni 的视频提示词怎么写才稳?本文按 Google 官方视频提示指南和最佳实践,拆解提示词的 7 个组成部分,讲清音效与对白写法、负面提示、图生视频和多镜头角色一致的技巧,附可复制模板。

    Gemini0
  6. 06

    NotebookLM 怎么用:改名 Gemini Notebook 后的入口、三栏界面与基本流程

    NotebookLM 是什么、怎么用?2026 年 7 月它已改名 Gemini Notebook。本文按官方帮助中心讲清改名后哪些变了、使用条件、「来源 → 对话 → Studio」三步流程,以及回答不出来时的官方原因。

    Gemini0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~