用途:为 OpenCode 创建自定义命令,把重复性任务(如跑测试、审查改动)固化为可复用的斜杠命令,在 TUI 中输入 /命令名 即可执行。
主要能力:命令可用 Markdown 文件或 opencode.json 的 command 配置定义。Markdown 文件放在项目 commands/ 目录或全局 ~/.config/opencode/commands/,文件名即命令名(test.md → /test)。frontmatter 可设置 description、agent、model 等属性,正文即提示词模板。提示词支持 $ARGUMENTS 传入全部参数,$1、$2、$3 传入位置参数;用 !command 注入 Shell 输出;用 @path/to/file 引入文件内容。配置项包括 template(必填)、description、agent、subtask、model。自定义命令可覆盖 /init、/undo、/redo、/share、/help 等内置命令。
使用方式:mkdir -p commands 后创建 commands/<name>.md,写入 frontmatter 与提示词模板,然后在 TUI 输入 /<name> 调用。
适用场景:测试执行与覆盖率分析、代码审查、组件或文件生成等可模板化的重复任务。
限制:命令在项目根目录运行;具体模型与 agent 取值取决于本地配置;官方文档见 https://opencode.ai/docs/commands/。