用途:为 OpenCode 创建自定义斜杠命令,把测试、代码审查、组件生成、部署等重复任务固化为可复用提示词,在 TUI 中用 /命令名 触发。
主要能力:命令模板支持 $ARGUMENTS 传入全部参数、$1/$2 等按位置取参、!command 注入 Shell 输出、@path/to/file 引用文件内容;frontmatter 可设 description、agent、subtask。命令可放在项目级 .opencode/commands/ 或全局 ~/.config/opencode/commands/,也可写入 opencode.jsonc 的 command 字段。
使用方式:创建 .opencode/commands/test.md,写入 frontmatter 与模板内容,然后在 TUI 输入 /test。JSON 方式则在 opencode.jsonc 中配置 template、description、agent 等。
限制与注意:资料明确要求命令 frontmatter 只能指定 agent,不得写 model,模型统一在 opencode.json 的 agent 层配置;agent 字段必填,需向用户确认用 build(创建/修改文件、测试、构建、部署)还是 plan(分析、审查、只读)。自定义命令会覆盖同名内置命令。资料中示例 frontmatter 出现 model 字段,与上述规则冲突,应以规则为准。内置命令包括 /init、/undo、/redo、/share、/help。
适用场景:测试执行、代码审查、组件生成、部署、文档生成等重复工作流。
暂未提供:具体版本要求、权限与安全边界、性能数据等。