用途
Command Creator 用于在 OpenCode 中创建斜杠命令（slash command）。斜杠命令是存储在 .opencode/commands/（项目级）或 ~/.config/opencode/commands/（全局/用户级）中的 Markdown 文件，在 OpenCode 对话中通过 /command-name 调用时会展开为提示词。
该技能适合以下场景：
- 重复性工作流（代码审查、PR 提交、CI 修复）
- 需要保持一致性的多步骤流程
- 智能体委派模式
- 项目专属自动化
当用户提出“创建一个命令”“做一个斜杠命令”“添加一个命令”，或表示“我一直在做 X，能不能做成命令”时，可调用此技能。
主要能力
技能附带以下参考文档，供创建命令时按需加载：
references/patterns.md：命令模式（工作流自动化、迭代修复、智能体委派、简单执行）references/examples.md：真实命令示例及完整源码（submit-stack、ensure-ci、create-implementation-plan）references/best-practices.md：质量检查清单、常见陷阱、写作指南、模板结构
命令结构
每个斜杠命令是一个 Markdown 文件，包含：
---
description: 在 /help 中显示的简要描述（必填）
argument-hint: <placeholder>（可选，命令接受参数时使用）
---
# 命令标题
[供智能体自主执行的详细指令]
使用方式
技能按以下工作流引导创建命令：
第 1 步：确定位置
自动检测合适位置：
- 检查 git 仓库状态：
git rev-parse --is-inside-work-tree 2>/dev/null - 默认位置：在 git 仓库中 → 项目级
.opencode/commands/；不在 git 仓库中 → 全局~/.config/opencode/commands/ - 允许用户覆盖：用户明确提到“global”或“user-level” → 使用
~/.config/opencode/commands/；用户明确提到“project”或“project-level” → 使用.opencode/commands/ - 继续前向用户报告所选位置
第 2 步：展示命令模式
加载 references/patterns.md 查看可用模式：
- 工作流自动化 - 分析 → 执行 → 报告（如 submit-stack）
- 迭代修复 - 运行 → 解析 → 修复 → 重复（如 ensure-ci）
- 智能体委派 - 上下文 → 委派 → 迭代（如 create-implementation-plan）
- 简单执行 - 带参数运行命令（如 codex-review）
询问用户：“哪个模式最接近你想创建的内容？”
第 3 步：收集命令信息
询问用户关键信息：
A. 命令名称与用途
- “命令应该叫什么？”（用于文件名）
- “这个命令做什么？”（用于 description 字段）
- 命令名称必须使用 kebab-case（连字符，而非下划线）：正确如
submit-stack、ensure-ci、create-from-plan；错误如submit_stack、ensure_ci、create_from_plan - 文件名与命令名一致：
my-command.md→ 以/my-command调用 - 描述应简洁、以动作为导向（显示在 /help 输出中）
B. 参数
- “这个命令接受参数吗？”
- “参数是必填还是可选？”
- “参数代表什么？”
- 若接受参数：在 frontmatter 中添加
argument-hint: <placeholder>；必填参数用<尖括号>，可选参数用[方括号]
C. 工作流步骤
- “这个命令应遵循哪些具体步骤？”
- “它们应按什么顺序发生？”
- “应使用哪些工具或命令？”
- 收集细节：初始分析或检查、主要动作、结果处理、成功标准、错误处理方式
D. 工具限制与指引
- “这个命令应使用特定智能体或工具吗？”
- “是否有应避免的工具或操作？”
- “是否应读取特定文件以获取上下文？”
第 4 步：生成优化后的命令
加载 references/best-practices.md 获取模板结构、最佳实践、写作风格指南和质量检查清单。关键原则：使用祈使/不定式形式（动词开头的指令）、明确具体、包含预期结果、提供具体示例、定义清晰的错误处理。
第 5 步：创建命令文件
- 确定完整文件路径：项目级
.opencode/commands/[command-name].md；全局~/.config/opencode/commands/[command-name].md - 确保目录存在：
mkdir -p [directory-path] - 使用 Write 工具写入命令文件
- 向用户确认：报告文件位置、总结命令功能、说明使用方法
/command-name [arguments]
第 6 步：测试与迭代（可选）
- 建议测试：可通过运行
/command-name [arguments]测试此命令 - 根据反馈迭代，按需更新文件
快速提示
- 设计命令工作流时加载
references/patterns.md - 查看现有命令结构时加载
references/examples.md - 定稿前加载
references/best-practices.md确保质量 - 常见模式：使用 Bash 工具执行 pytest、pyright、ruff、prettier、make、gt 命令；使用 Task 工具调用子智能体处理专门任务；继续前先检查特定文件（如
.PLAN.md）；立即标记待办完成，而非批量处理；包含明确的错误处理指令；定义清晰的成功标准
适用场景
- 需要将重复性工作流固化为可复用命令
- 需要为团队或项目建立一致的多步骤流程
- 需要将任务委派给子智能体并保持流程一致
- 需要创建项目专属或全局命令
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。