版本说明：本文基于 OpenCode v1.2 和 Claude Code v2.1 编写，命令语法和 Skill 机制均来自官方文档及社区实践。

适用对象：技术负责人、团队架构师、希望将 AI 工作流标准化和自动化的开发者。

前置知识：已了解 AGENTS.md / CLAUDE.md 配置体系（第10-11篇），理解项目接入流程（第12篇）。

当团队中每个人都用不同的方式让 AI 做代码审查、生成测试、更新文档，产出的质量参差不齐，流程无法复用。自定义命令解决的就是这个问题——把团队的最佳实践封装成可复用、可共享、可版本管理的标准化指令。

本文以 OpenCode 自定义命令体系为主体（70%），Claude Code Skill 为对照（30%），讲解从单命令开发到团队共享仓库搭建的完整路径 。

一、自定义命令的价值

1.1 为什么需要自定义命令

没有自定义命令时，团队成员每次手动输入一段长 Prompt 描述任务要求、输出格式、质量标准。这种方式有三个根本问题：一致性差（每个人审查标准不同）、效率低（每次从零编写重复 Prompt）、无法积累（好的经验留在个人电脑里）。

自定义命令本质上是参数化的 Markdown 模板，团队统一维护、统一调用，所有人获得相同质量的 AI 输出 。

1.2 命令自动化的三个层次

企业级应用的核心是第二和第三层。

二、OpenCode 自定义命令体系

2.1 命令开发基础

OpenCode 的自定义命令是存放在 .opencode/commands/ 目录下的 Markdown 文件，文件名即命令名，在 TUI 中输入 /命令名 即可调用 。

命令文件基本结构：

---
description: 对指定文件执行代码审查
---

请对 $ARGUMENTS 进行代码审查，重点关注以下方面：

1. 安全性：是否存在注入、XSS、敏感信息泄露
2. 性能：是否有 N+1 查询、不必要的循环
3. 可读性：命名是否清晰、注释是否充分
4. 规范性：是否符合团队编码规范

输出格式：
- 每个问题单独一段，标明文件名和行号
- 最后给出严重程度评级：高/中/低
- 附带修复建议

--- 之间的 YAML front matter 定义命令元信息，description 在命令列表中显示 。

占位符语法：OpenCode 支持三种占位符 ：

• $ARGUMENTS：接收调用时传入的全部参数，也可用 $1、$2 等位置参数单独引用
• $NAME：命名参数（如 $FILE、$FRAMEWORK），大写字母、数字和下划线组成，调用时以 name:value 形式传入