用途:创建用户可调用的 OpenCode 斜杠命令,把重复的工作流固化为 /command 快捷方式,并统一智能体与模型的路由。
主要能力:命令可定义在项目级 .opencode/command/<name>.md、全局级 ~/.config/opencode/command/<name>.md,也可内联在 opencode.json 的 command 字段中(含 template 与 description)。frontmatter 支持 description(必填)、agent(路由到指定智能体,如 plan 用于只读研究)、model(覆盖模型)、subtask(为 true 时通过 task 工具作为后台任务运行)。模板占位符包括 $ARGUMENTS(命令后全部参数)、$1、$2 等位置参数、!cmd(shell 命令输出,如 !git status)、@filename(注入文件内容,如 @src/main.ts)。
使用方式:编写 Markdown 命令文件并填写 frontmatter 与模板正文,可组合参数、文件上下文与 shell 输出。创建后先运行 opencode run "test" 验证,再用 /your-command test arguments 测试。
适用场景:频繁重复的同类请求、需要一致的智能体或模型路由、需要注入文件上下文或 shell 输出、以及耗时较长的后台研究任务。一次性任务建议直接提问,不必建命令。
限制与建议:description 应控制在 80 字符以内;只读操作建议使用 agent: explore 或 agent: plan;长任务使用 subtask: true;不要创建与现有工具重复的命令,不要路由到不存在的智能体,修改后需测试。资料未提供更多安装或收费信息。