2. 认识一下“自定义命令”

Gemini CLI 提供一系列内置命令，帮助用户管理会话、自定义界面以及控制行为。这些命令以斜杠 / 开头。

Gemini CLI 内置了一系列命令，如/help、 /clear、 /copy 等。

官方文档是这么说的 ????： 自定义命令允许用户在 Gemini CLI 中将最常用的提示保存并重复使用为个人快捷方式。您可以创建特定于单个项目的命令，或全局适用于所有项目的命令，从而简化工作流程并确保一致性。

我们可以注意到, 利用自定义命令可以管理我们的提示词，正符合我的需求，因此我决定使用自定义命令来实现灵活的系统提示词。

3. 三步创建你的第一个命令

Gemini CLI 从两个位置发现命令，并按特定顺序加载：

1. 用户命令（全局）： 位于 ~/.gemini/commands/。这些命令在用户正在处理的任何项目中都可用。
2. 项目命令（局部）： 位于 /.gemini/commands/。这些命令特定于当前项目，可以检入版本控制以便与团队共享。

如果项目目录中的命令与用户目录中的命令同名，将始终使用项目命令。这允许项目使用特定于项目的版本覆盖全局命令。

命令的名称由其相对于 commands 目录的文件路径决定。子目录用于创建命名空间命令，路径分隔符（/ 或 \）将转换为冒号（:）。

• ~/.gemini/commands/test.toml 中的文件变为命令 /test。
• <project>/.gemini/commands/git/commit.toml 中的文件变为命名空间命令 /git:commit。

自定义命令定义文件必须以 TOML 格式编写，并使用.toml 文件扩展名。

• prompt (字符串)：执行命令时将发送给 Gemini 模型的提示。这可以是单行或多行字符串。
• description (字符串)：命令功能的简短单行描述。此文本将显示在 /help 菜单中命令旁边。如果省略此字段，将根据文件名生成通用描述。

下面我给一个示例，可以简单的看一下

添加该文件后，就可以在 Gemini 中调用 /prdspliter 命令来拆解需求。

{{args}} 是 Gemini CLI 的占位符，表示用户在命令输入的全部内容。如果做简单的提示词管理，目前就已经足够了。

但是如果想做更复杂的逻辑，比如结合命令行工具等，应该怎么做呢？

4. 终极玩法：让自定义命令与Shell联动起来

您可以通过直接在 prompt 中执行 shell 命令并注入其输出来使命令具有动态性。这非常适合从本地环境收集上下文，例如读取文件内容或检查 Git 状态。

当自定义命令尝试执行 shell 命令时，Gemini CLI 现在会提示您确认，然后才继续。这是一种安全措施，可确保只运行预期的命令。

工作原理：

• 注入命令： 在 prompt 中使用 !{...} 语法指定命令应在何处运行以及其输出的注入位置。
• 确认执行： 当您运行命令时，将出现一个对话框，列出 prompt 想要执行的 shell 命令。
• 授予权限： 您可以选择：
  • 只允许一次： 命令将只运行这一次。
  • 本会话始终允许： 命令将被添加到当前 CLI 会话的临时允许列表中，不再需要再次确认。* 否： 取消 shell 命令的执行。

CLI 仍然遵循全局的 excludeTools 和 coreTools 设置。

示例 (git/commit.toml)：

此命令获取暂存的 Git 差异，并用它来要求模型编写提交消息。

当用户运行 /git:commit 时，CLI 首先执行 git diff --staged，然后用该命令的输出替换 !{git diff --staged}，最后将完整的提示发送给模型。

小结

总而言之，Gemini CLI 的自定义命令绝对是个值得深挖的功能，它能极大地提升我们的工作流效率。

为了方便大家，我已经把文中提到的 git:commit 和其他几个我私藏的实用命令都整理好了，放到了 GitHub 仓库里。