02 命令(Command):用户侧提示模板

02 命令(Command):用户侧提示模板

本节摘要:四类能力里,本节讲命令(Command)——用户侧的提示模板,输入 /某命令 展开成预设提示发给会话。本节讲清 OpenWork 如何管理命令(CRUD),以及它和技能的根本区别(用户触发 vs 模型按需)。

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

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

输入: /deploy
   │
   ▼ 命令展开
预设提示: "请按部署流程,先跑测试再构建再发布..."
   │
   ▼ 发给会话
   │
   ▼ Agent 按这段提示干活
​

命令的底层机制和 OpenCode 教程第 11 章讲的斜杠命令一样。OpenWork 在这之上加了「管理」。

二、OpenWork 如何管理命令(CRUD)

OpenWork 服务端对命令的 CRUD:

命令是 .md 文件,存在命令目录:
<root>/.opencode/commands/deploy.md
<root>/.opencode/commands/review.md
...
​

命令文件就是一段提示模板(可含占位符)。OpenWork 扫描这些 .md 文件,注册成可用命令。

三、命令的格式

命令文件是 Markdown,内容就是提示模板。有时还带 frontmatter(前置元数据),如指定用什么模型:

---
model: 某模型
---
请审查当前工作区的改动,重点关注:
1. 潜在 bug
2. 性能问题
3. 安全风险
​

OpenWork 扫描时会解析 frontmatter(如果有的话),还可能「修复」legacy 命令文件(自动补全缺失的 frontmatter 字段)——这是兼容旧格式的贴心处理。

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

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

举例:

• 「我每次提交前都让 AI 审代码」→ 做成命令 /review,用户每次主动敲。
• 「AI 遇到 PDF 时遵循某规范」→ 做成技能,模型遇到 PDF 自动读。

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

五、命令的可分享性

和技能一样,命令也可分享:

• 工作区内分享(队友连工作区就能用)
• 经市场分享(企业版)

命令作为「能力」的一种,同样享受 OpenWork 的分享体系。

六、命令与技能的互通

有个有趣的细节:技能的正文也可作为命令模板。也就是说,一个技能既能被模型按需读(技能用法),也能被用户主动调(命令用法)。这把两类能力连起来了。

技能 pdf-handler 的正文
   │
   ├─ 模型按需读 ──► 技能用法
   │
   └─ 用户主动调(/pdf-handler)──► 命令用法
​

这种互通让你写一份内容,两种用法都支持——灵活且不重复。

七、本节要点回顾

1. 命令是用户提示模板:/命令 展开成预设提示发给会话。
2. 底层同 OpenCode 斜杠命令,OpenWork 加管理。
3. CRUD:list / upsert / delete,命令是 .md 文件。
4. 可带 frontmatter:指定模型等元数据;legacy 文件自动修复。
5. 命令 vs 技能:命令用户主动(用户驱动),技能模型按需(模型驱动)。
6. 可分享:工作区内 + 市场。
7. 与技能互通:技能正文可作命令模板,一份内容两种用法。

命令讲清了,下一节讲 MCP——把外部工具拉进来。