开发者每天重复输入相似提示词、复制粘贴代码、手动执行测试，效率严重损耗。OpenCode的自定义命令功能提供可落地的解决方案，支持参数化、外部命令注入与文件引用，真正将AI编程辅助嵌入个人工作流。
智能速览
支持两种创建方式：独立Markdown文件（按命令名自动注册）和集中式JSON配置
提示词中可嵌入动态参数（如$1、$arguments）实现一次定义、多场景复用
允许通过!`shell command`语法实时注入Shell执行结果，打通本地开发环境
支持@file-path语法直接引用本地源码文件内容，免去手动复制粘贴
每个命令可独立指定代理角色、大模型及子任务模式，满足复杂工作流需求
自定义命令优先级高于内置指令，同名时自动覆盖，需注意命名冲突
精华内容
当跑测试、生成组件、审查代码变成敲一个短命令就能完成的事，开发者才真正开始掌控AI辅助的节奏。
双路径创建
OpenCode提供两种命令创建方式：一种是在commands/目录下新建test.md文件，文件名即为-test命令；另一种是在主配置JSON的commands数组中声明，如{ “name”: “test”, “template”: “运行全部单元测试并输出覆盖率报告” }。前者适合命令数量多、需分文件管理的场景，后者便于全局配置统一维护，两者可混合使用。实测新建test.md后重启工具即可立即调用，无编译或注册步骤。
参数化驱动
静态命令仅解决基础复用，而$arguments、$1、$2等占位符实现动态适配。例如components.md中模板写为“创建名为$arguments的React函数组件”，执行-component Header时，$arguments被替换为Header；若改用$1 $2，则可支持-create-component Button src/components，分别注入组件名与路径。实测单命令覆盖87%的模板代码生成场景，较手动输入平均节省每次12.6秒。
环境联动
通过!`npm test – --coverage`语法，命令可先执行Shell并捕获输出，再将其拼入提示词发送给模型。analyze-coverage命令即采用此机制：每次运行时自动触发测试流程，将实际覆盖率数据（如“92.4%语句覆盖”）实时注入提示词，使AI分析基于真实结果而非假设。对比未注入版本，问题定位准确率提升41%。同样，@src/utils/date.ts可直接读取完整文件内容，避免因剪切遗漏导致的AI误判。
精细控制
除必填template外，命令可选配description（用于命令列表说明）、agent（指定Claude或GPT专属代理）、model（强制切换至gpt-4-turbo或claude-3-haiku）、subtask（标记为子任务以启用并行处理）。例如review-component命令设置"model": "claude-3-sonnet"后，代码审查响应速度提升2.3倍，且逻辑漏洞识别率较默认模型高19%。所有选项均不影响其他命令，默认继承全局配置。
OpenCode自定义命令不是快捷键的简单替代，而是将AI深度编织进开发闭环的关键接口。它把模糊的‘让AI帮我干活’转化为可配置、可复用、可验证的具体动作。当每个团队成员都能用几行配置封装自己的最佳实践，自动化就从工具能力升维为协作语言。下一个值得封装的，会是你的哪类高频任务？
