03 斜杠命令模板

03 斜杠命令模板

本节摘要:四类扩展点里,**斜杠命令(slash command)**是最轻的——它是用户侧的提示词模板,输入 /某命令 就展开成预设提示发给会话。本节讲清斜杠命令的本质、它和技能的根本区别(用户触发 vs 模型按需)、以及它从哪来。理解了本节,你就知道何时该用命令、何时该用技能。

一、斜杠命令是什么:用户快捷方式

斜杠命令是用户主动触发的提示模板。你输入 /某命令,它展开成一段预设的提示,发给当前会话,就像你自己打了那段话一样。

你输入: /review
   │
   ▼ 命令展开
预设提示: "请审查当前工作区的改动,重点关注潜在 bug 和改进点..."
   │
   ▼ 发给会话(像你亲手打的)
   │
   ▼ Agent 按这段提示干活
​

它的价值是「快捷」——把常用的、固定的提示存成命令,下次一个 / 就发起,不用每次重打。

二、命令从哪来:三个来源

OpenCode 的命令来自三个来源:

配置 + 内置

用户可以在配置里定义自己的命令,每个命令是一段提示模板。OpenCode 还自带几个:

• init:初始化项目(生成 AGENTS.md 引导文件)
• review:审查当前改动

MCP prompts

MCP server 可以提供「prompts」(预设提示),这些也能作为命令用。它们的参数用 $1/$2 占位,调用时填入。

技能内容

技能的正文(第 02 节)也能作为命令模板——这把「技能」和「命令」连起来了:一个技能既能被模型按需读(技能用法),也能被用户主动调(命令用法)。

三、命令模板的占位符

命令模板支持占位符(hints),让命令更灵活。最典型的是 $N(位置参数)和 $ARGUMENTS(全部参数):

命令模板: "请把 $1 重构为 $2 风格"
   │
   ▼ 调用: /refactor auth 模块化
   │
   ▼ 展开后: "请把 auth 重构为 模块化 风格"
​

OpenCode 会从模板里提取这些占位符,作为命令的「参数提示」——调用时如果你没传够参数,会提示你补。

四、命令 vs 技能:根本区别

这是本节最该记住的对比。命令和技能都「含预设提示」,但触发方式和定位完全不同:

举例对比:

• 场景「我每次提交前都要让 AI 审一下代码」 → 做成斜杠命令 /review。用户每次提交前主动敲 /review。
• 场景「AI 遇到 PDF 处理时要遵循某规范」 → 做成技能 pdf-handler。模型遇到 PDF 任务时自动读它。

💡 判断标准:「我主动想发起这个」用命令;「我希望模型遇到 X 时自动懂怎么做」用技能。一个是用户驱动,一个是模型驱动。

五、命令的轻量性

命令是四类扩展点里最轻的:

• 不用写代码(只是提示文本)
• 不用注册钩子(就是个模板)
• 不占模型 token(展开前只是个菜单项)

所以命令适合「快速把常用提示固化下来」——想重复用某段提示,做成命令,不用重写。

六、内置命令举例

OpenCode 自带几个有用的命令,可作为参考:

• init:初始化项目,生成 AGENTS.md(给 Agent 的项目说明文件)——这是「让 Agent 理解你的项目」的起点。
• review:审查当前工作区的改动——典型的「提交前自检」用途。

项目自身的 .opencode/command/ 目录通常还有更多项目专用命令(如 commit、changelog、translate 等),它们是「这个项目常用的提示」被固化成命令的实例。

七、本节要点回顾

1. 斜杠命令:用户主动触发的提示模板,/命令 展开成预设提示发给会话。
2. 三个来源:配置+内置(如 init/review)、MCP prompts、技能内容。
3. 占位符:$N / $ARGUMENTS,让命令带参数;调用时按提示补全。
4. 命令 vs 技能根本区别:命令用户主动触发(用户驱动),技能模型按需读取(模型驱动)。
5. 判断标准:「我主动发起」用命令;「模型遇到 X 时自动懂」用技能。
6. 命令最轻:不写代码、不注册钩子、不占 token,适合固化常用提示。

四类扩展点讲了三个(插件/技能/命令),下一节讲最后一个——自定义工具,以及如何把它们组织进项目。