一、为什么要单独理解 Slash Command

用 Agent 做事时经常会遇到以 / 开头的输入：

/help/new/model

这类输入就是 Slash Command。

它看起来像一句聊天消息，但本质上更接近“命令”。怎么说呢，普通消息通常会进入大模型推理流程。由模型理解意图，再决定是否使用工具；Slash Command 则会先被 Agent 的命令程序拦截和解析，接下来按命令名触发固定逻辑。

这也是我觉得它值得单独讲清楚的原因：Slash Command 不是 Prompt 的另一种写法，而是 Agent 程序里的一个控制入口。

使用者痛点：在实际使用中。很多人把 “/help” 当成普通提问，导致程序走了不必要的推理方法，耗时又费 token。

理解这个入口后很多问题就容易解释了：

• 为什么 /help 不需要模型推理，也能直接显示帮助信息？
• 为什么 /new 可以直接开启新会话？
• 为什么有些开源项目安装后会在 Claude Code、Gemini CLI、Hermes 这类 Agent 里多出自己的命令？
• 为什么 Hermes 可以通过配置新增 /greet/wechat-gzh 这样的自定义命令？

这篇文章围绕这些问题展开。主要放在 Slash Command 本身，而不是 Skill 的基础概念。

Slash Command 是 Agent 会话中的一种“命令式输入”。它通常以 / 开头，后面跟命令名和可选参数。

例如这方面，

/help/model gpt-/wechat-gzh abc/def.md

一条 Slash Command 通常可以拆成两部分：

/wechat-gzh abc/def.md
└─────────┘ └────────┘
命令名 参数

说到也就是，

命令名：/wechat-gzh
从参数来看。abc/def.md

Agent 收到这类输入后一般不会马上把整句话当作自然语言丢给模型，而是先执行类似下面的流程：

↓Agent 判断这是 Slash Command
↓解析命令名和参数
↓查找命令注册表、Quick Command、插件命令或 Skill 命令
↓执行对应逻辑
↓返回结果，或者改变当前会话状态

Slash Command 的关键点不是“让模型理解得更好”，而是“让程序更确定地触发一个动作”。

示例对比

自然语言：

帮我开一个新会话

Agent 需要先理解意图，再决定是否调用对应工具。不过，

Slash Command：

/new

程序直接把它识别为“开启新会话”。

三、Slash Command 解决了什么问题

四类常见场景

1️⃣ 会话控制命令

/new /clear /retry /undo /compress /quit 等，用来管理当前对话状态。

2️⃣ 配置和状态命令

/model /config /tools /status /usage 等。用于查看或修改 Agent 运行状态，返回确定的程序行为而非开放式回答。

3️⃣ 能力加载命令

通过短命令直接触发某个 Skill、工作流或插件，例如 Hermes 中的特定业务脚本。

4️⃣ 使用者自定义命令

如 /greet。/wechat-gzh abc/def.md 等，通过配置或插件快速映射到已有功能。

四、开源项目为什么安装后能提供自己的命令

实现方式概览

• 文件型命令：约定目录结构（如 .claude/commands/xxx.md)。适合分发工作流，但仅限特定 Agent。
• 注册表型命令：Agent 源码维护一张全局注册表，每个条目包含名字、说明、参数与处理函数。Hermes 就采用此方式，便于 CLI 自动补全与帮助生成。缺点是需要修改源码，
• 插件型命令：项目提供插件，在运行时向 Agent 注册新 Slash Command，无需改动主要代码。适合可复用
• MCP 或工具型入口：CLI/MCP Server 提供能力，Agent 通过工具发现机制调用。表面看似 Slash Command，但底层是工具调用。其实，

五、Hermes 里自定义 Slash Command 的几种方式

Quick Command

• Pain point: 想增加明显一个固定输出或脚本。却不想改源码，

quick_commands:
从greet来看。type: exec
command: "printf 'Hello,nice to meet you!'"
wechat-gzh:
再看type，alias # 指向另一个已有 Slash Command

• Pain point: 需要把长 Skill 名称压缩为易记短名。

1. A 在注册表里新增定义；
\
2. B 在 CLI/Gateway 中实现 handler；
\
3. C 补充帮助、自动补全及权限控制。
\
4. D 完成单元测试。
\ <\/ol>

插件命令

• A 提供独立仓库；
\
• B 安装后自动向 Hermes 注册新 command；
\
• C 支持跨团队分发与版本管理。
\ <\/ul>

Skill 动态命令

• A 将已有 Skill 注册为动态 command；老实说，
\
• B 用 alias 为其创建简短入口；
\ C 保持完整业务逻辑在 Skill 内部，不被 alias 干扰。\ <\/ul>

六、实践一：用 Quick Command 实现 /greet

\ \textbf {目标效果} \ \text{ 输入 } \texttt {/greet} \text{ 输出 } \texttt {Hello,nice to meet you!} \end{itemize} bash bash bash ** ## 七 ### 十 --- User wants restructured with html tags and embedding user pain points,using h2/h3 headings only. The assistant gave a garbled output with repeated tags and errors. We need to produce a clean HTML document with proper headings。preserving original sections and adding user pain points where relevant. Let's rewrite from scratch: Sections: 1. 为什么要单独理解 Slash Command Add pain point bullet after explanation. Include example breakdown. Use h3 for sub-subsections like 示例对比. But only h2/h3 allowed;ok. Continue sections as per original. Make sure code blocks are in `

使用者痛点：" before bullet lists maybe.
Let's create final answer now.

在使用 Agent 时你经常会看到以斜杠开头的输入。例如
/help/new/model

这类输入正是S​lash Command​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​‍‍‍‍‍‍‍‍‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‌‏‏‏‏‏‏‏‏‎‎‎‎‎‎‎ ‎ ‎ ‎ ‎ ‎ ‏‏ ‏‬   ⁠⁠⁠⁠⁠⁠⁠⁠⁠🟣🟣🟣🟣🟣🟣🟣🟣️️️️️️️️️⏹⏹⏹⏹⏹⏹⏹⌚⌚⌚⌚⌚⌚⌚❎❎❎❎❎❎❎✖✖✖✖✖✖✖
) 看起来像普通聊天消息，却实质上是“一条指向程序行为的指令”。普通消息会进入大模型推理，由模型判断意图并决定是否调用工具；而 Slash Command 会
被 Agent 的指令解析层拦截，接下来直接跳转到对应的处理逻辑。使用者痛点 ① : 经常把 “/help” 当成普通提问。从而导致一次不必要的 LLM 推理，浪费时间和 token。使用者痛点 ② : 不清楚哪些操作可以用快捷指令完成，以至于每次都要手动敲完整自然语言描述。把 Slash Command 单独抽出来讲，对...有帮助快速定位并解决上述困惑。


/help 能直接展示帮助信息而无需模型推理？不过，——因为它被指令程序提前捕获并返回静态文档。

/new 能立即开启新会话？——同理，被视作内部控制指令。


某些开源项目安装后出现自定义指令？——因为它们实现了对应网站的
机制。


Hermes 能通过配置新增 /greet、/wechat‑gzh 等自定义指令？——通过 Quick Command 或插件机制实现。


S​lash Command 是 Agent 会话中的一种「指令式输入」——以「/\」开头，随后跟随**指令名称**还有**可选参数**。



/help/model gpt‑/wechat‑gzh abc/def.md



/wechat‑gzh abc/def.md
└───────────────┘ └───────┘
指?，参数文本 

⬇︎ 判断为 slash command
⬇︎ 解析 name + args
⬇︎ 在 注册表／Quick Command／插件／Skill 中查找匹配项
⬇︎ 调用相应 handler
⬇︎ 返回结果或改变会话状态 

自然语言 → “帮我开一个新会话” → LLM 理解 → 决定调用 new 会话 API
Slash command → “/new” → 程序直接执行 new 会话 API，无需 LLM 步骤。

使用者痛点 ③ : 想快速切换模型却总要写完整描述。如 “请切换到 GPT‑4 并开启温度 0.7”，其实只需要 /model gpt‑4 --temp=0.7 即可。

使用者痛点 ④ : 多次手动复制粘贴长方法 src/docs/tutorials/example.md 导致错误，可通过 /open src/docs/tutorials/example.md 简化操作。


S​lash Command 分类概览：




类别 
典型示例 & 痛点说明 


① 会话控制指令

/new – 创建全新空白会话
* 痛点：每次想重新开始都要敲完整句子，“请重新开始”。使用 /new 即可瞬间完成。话说回来，/clear – 清空上下文
* 痛点：忘记历史记录占用 token。需要手动提醒 LLM 清除。/undo,/retry。/compress,/quit…同理，





② 配置 & 状态查询指令

/model gpt‑4 – 切换大模型
* 痛点：频繁实验不同模型时总得打开设置页面再切换，用 /model … 更快捷。/config show – 查看当前配置细节
/tools list – 列出已加载工具
/status,/usage – 查看资源消耗情况
…




③ 能力加载指令

/markdown-to-html file.md – 调用 Markdown 渲染 Skill
/...customSkill args… – 任意已注册 Skill





④ 使用者自定义快捷指令

/greet → 输出固定欢迎语句


/wechat‑gzh path/to/article.md → 实际映射到长 Skill 调用

…


S​lash Command 工作原理简述 :




🔍 检测前缀 '/' -> 判定为 command.

🔧 拆分 name 与 rawargs.

📂 在 注册表quickcommands插件 或 skill registry 中查找匹配项.

⚙️ 调用对应 handler:
• exec → 执行本地 shell 命�.
• alias → 重写为另一条 slash command 并递归处理.
• skill → 启动 skill 流程 .




…⬤ 返回结果或更新 session state.
.
.
.
.
…，…，…. 

---