Gemini CLI Skills 入门：从环境到第一个可用技能

gemini镜像站入口：chat.aimirror123.com
gemini 镜像备用站：gemini-3.shop。
摘要：本文用最短路径带你装好 Gemini CLI、开启 Skills，并用一个“内容运营经理”示例技能跑通从输入到输出的完整链路。

先搞清楚：CLI + Skills 能做什么

如果你一直在网页里和 Gemini 对话，CLI 的意义可能不明显。但一旦你需要“稳定复用”的结果， CLI + Skills 就会成为最省力的方式：你把指令写进一个可维护的文件，模型每次都按同一套规则输出。

简单说，CLI 负责把模型搬进你的本地工作流，Skills 负责把“临时对话”变成“可复用的技能包”。 这让你可以把 AI 当成一个固定角色，而不是每次从零解释需求。

你会看到两个明显变化：第一，输出变“可预测”，因为每次调用都走同一套规则；第二，协作更顺， 团队成员不需要重复写提示词，只要复用同一个技能文件即可。对于教程写作、运营复盘、需求整理这类 高频任务，Skills 的价值尤其明显。

本文强调“最小可用”，不是因为要省事，而是为了让你快速完成一轮闭环：写规则、跑输出、检查问题。 只要闭环跑通，后续加工具、加格式、加权限都会更稳。

• 普通对话：一次性回答，依赖即时描述，结果漂移更大。
• Skills：可版本化、可复用、可共享，适合高频流程。
• CLI：让模型进到本地环境，便于和文件、脚本一起工作。
• 最佳组合：把“经验”写成规则，把“流程”写成技能。

准备环境与必要工具

你只需要准备 3 样东西：Node.js（安装 CLI）、终端（运行命令）、一个可写的本地目录（放 Skills）。 另外，确保网络可以访问 Google 登录页面，这是 CLI 授权的关键步骤。

建议提前准备一个“专用工作区”，例如在桌面或文档里新建一个 gemini-workspace， 后续的 Skills、输出示例和测试文件都放在同一个地方，方便备份和迁移。

• 系统：Windows 或 macOS 均可，Windows 建议 Windows 10 以上。
• 账户：一个可用的 Google 账号。
• 习惯：愿意敲几行命令，比点菜单更快。

如果你在公司网络环境下使用，建议先确认能正常访问 Google 授权页；否则就算 CLI 安装成功， 登录环节也会卡住。

最推荐的目录结构是：gemini-workspace / skills / examples。这样你可以把技能文件、 测试输入、输出样例放在同一个位置，方便回溯和复盘。

安装 Node.js：给 CLI 打地基

Gemini CLI 基于 Node.js，没装 Node，后面的命令就会提示找不到。推荐去官网下载安装包， 选择“稳定版 / LTS”，然后一路下一步即可。

Windows 用户注意勾选“添加到 PATH”；macOS 用户安装后通常会自动生效。不要安装过旧版本， LTS 版本最稳，适合大多数用户。

安装完成后，打开终端输入 node -v，能看到版本号就说明成功。 如果看不到版本号，通常是终端没有重启或者安装路径没生效。

你也可以再检查一次 npm -v。如果只有 node 有版本，npm 没有版本， 说明 PATH 可能没生效，重启终端通常能解决。

如果你需要同时维护多个项目，也可以考虑使用版本管理工具（如 nvm），但对新手来说不是必须。 先把 CLI 跑通最重要。

若公司电脑限制较多，安装全局包可能会提示权限不足。你可以先尝试用管理员权限安装， 或者让运维开放对应目录权限。不要急着改复杂方案，能装上并运行才是第一步。

打开终端并确认状态

Windows 用户可以用“运行”打开 cmd 或 PowerShell；macOS 用户按 Command + 空格搜索“终端”。 进入后先执行两条命令确认环境：

• node -v：确认 Node.js 是否就绪。
• npm -v：确认包管理器可用。

如果你看到版本号，就可以继续。如果提示命令不存在，建议重启终端或重新安装。

小技巧：如果你不熟悉命令行，记住两件事就够了——复制粘贴不会出错，执行命令后看到输出就是成功。 不要怕黑窗口，它只是一个高效的输入框。

你还可以在终端输入 pwd 或 cd 看当前目录， 这能帮助你确认技能文件保存的位置是否正确。

安装 Gemini CLI 并完成登录

安装命令很短，但要注意是全局安装。执行下面这行后，系统会自动下载 CLI 工具：

npm install -g @google/gemini-cli@preview

安装完成后，输入 gemini 启动。首次启动会跳出浏览器登录授权页面。 选择账号并允许访问后，页面提示成功即可回到终端。

登录完成后可以输入 gemini --version 查看当前版本。若想升级， 直接重复安装命令即可覆盖更新；若要卸载，使用 npm uninstall -g @google/gemini-cli。

这里使用的是预览版本（preview），好处是功能更新快，坏处是可能偶尔有小变动。 你可以在稳定后再固定版本，或者定期执行同一条安装命令进行更新。

创建第一个 Skills 文件夹

CLI 会在你的用户目录生成一个隐藏文件夹，用来存放技能包。通常路径类似： Windows 是 C:\\Users\\你的用户名\\.gemini，macOS 是 /Users/你的用户名/.gemini。

如果找不到这个目录，先运行一次 gemini 再退出，它会自动生成。 Windows 需要在文件夹里开启“显示隐藏项目”，macOS 需要用快捷键显示隐藏文件。

进入该目录后，新建一个 skills 文件夹，再创建一个子文件夹， 比如 content-ops，用来放今天的示例技能。

建议每个技能用一个单独文件夹，名字尽量短、英文、小写，便于在命令行中快速引用。

Windows 用户务必开启“显示文件扩展名”，避免 SKILL.md 实际变成 SKILL.md.txt。 这也是技能不生效的第一大原因。

写入最小技能说明书

在 content-ops 里新建一个 SKILL.md 文件。这个文件就是技能说明书， 你需要在里面定义角色、输入边界、输出结构。下面是一份精简模板，你可以直接改：

---
name: content-ops
---
# 内容运营经理
你是有 8 年经验的内容运营经理。用户提供主题与目标后，请输出：
1) 文章结构大纲（5-7 个标题）
2) 每个标题的关键要点（每点 2-3 条）
3) 一句可用的标题建议
风格：简洁、可执行，避免夸张宣传语。
      

这是最小版本：不做文件写入，也不做复杂格式。你可以先跑通，再逐步加输出格式或工具调用。

记住三条原则：角色要具体、输出要固定、禁止项要明确。越简洁，越稳定。 如果你发现模型输出浮夸或跑题，优先把边界写清楚，而不是一味加提示词。

如果你希望输出更规整，可以加一个“示例输出”段落，告诉模型结果应该长什么样。 有了样例，模型更容易对齐预期。

• 输入边界：写清楚需要的最少信息，比如主题、目标、受众。
• 输出结构：固定标题数量、要点数量，避免自由发挥。
• 语气风格：避免宣传口吻，强调可执行与可复用。
• 拒绝范围：明确“不做什么”，例如不写长文、不做推断。

权限与路径规则

当你的技能需要“写文件”或“读取本地资料”时，请把权限和路径规则写清楚。 最安全的做法是锁定到一个固定目录，例如桌面或专用工作区，避免误写系统文件。

规则建议写成三句话：允许写入的目录、文件命名规则、失败时的提示方式。这样即使多人使用， 也不会因为路径不同而出错。

Windows 路径要使用双反斜杠或明确写成可复制的路径；macOS 路径以 /Users 开头。 如果团队里同时有 Windows 与 macOS 用户，最好把路径写成可替换占位符，再提醒用户修改。

启用并验证技能是否生效

启动 Gemini CLI 后，输入 /settings 打开设置，找到 Skills 相关开关，确保已经开启。 之后退出并重启 CLI，让配置生效。

某些版本里还需要开启 Preview features 和 Agent Skills，记得逐项检查。 设置改完后务必 /exit 退出，再重新启动一次，否则配置不会生效。

测试方法很简单，输入： 请用 content-ops 技能帮我做一篇“用户增长复盘”的文章大纲。 如果输出结构稳定、包含标题与要点，说明 Skills 已经生效。

你也可以在同一目录下创建多个 Skills，分别解决“摘要”“FAQ”“脚本”等不同任务。

建议每个技能先用 3 条不同输入测试：短输入、普通输入、复杂输入。只要三条都稳，说明可用。

如果你想让结果更加一致，可以在技能文件中明确“输出格式必须包含哪些标题”， 这样模型不会遗漏关键段落。

一旦确认可用，建议在技能文件顶部加上版本号或更新时间，后续迭代时更容易追踪改动。

另外可以把“测试输入 + 理想输出”存成样例，后续每次改动都用同一组输入回归测试， 这样你能快速定位是哪条规则导致变化。

常见问题与排查清单

初次使用最容易卡在三个点：命令找不到、技能不生效、输出不稳定。你可以按下面的清单排查：

• 命令找不到：确认 Node.js 已安装，并重启终端。
• 技能不生效：确认 SKILL.md 文件名无误、扩展名未被隐藏。
• 输出漂移：把目标写清楚、限制输出结构，并减少自由发挥空间。

• 登录失败：检查网络、浏览器拦截与账号权限。
• 路径报错：确认用户名和目录位置一致，避免中英文混用导致路径错误。
• 无输出：尝试在 CLI 中明确写出技能名称，避免默认对话模式。

如果仍然失败，建议用最小输入测试（只给主题，不加限制）， 等能稳定输出后再逐步加规则。

另外两个高频问题也值得注意：登录授权卡住、文件路径错误。前者通常是网络或浏览器拦截， 后者多半是用户名没改或路径拼写不对。遇到问题先从环境和路径检查，往往能快速解决。

如果你在输入时没有明确指出技能名称，CLI 可能会回到普通对话模式。 这时候输出会更随意。最简单的解决方法是直接点名技能或在提示中写明“使用某某技能”。 你也可以统一在团队规范里规定调用格式，减少歧义。

最后记住一点：遇到问题先回到“最小版本”。把技能文件缩到最短，只保留角色与输出结构， 如果这一步能跑通，再逐条加规则。这样排查效率最高。