用途 本技能用于在 Claude Code 中开发自定义斜杠命令(slash command)。斜杠命令是定义为 Markdown 文件的常用提示,Claude 在交互会话中执行它,从而提供可复用性、一致性、可分享性和效率。命令是写给 Claude 的指令,而非给用户的消息;调用 /command-name 时,命令内容成为 Claude 的指令,因此应以“让 Claude 做什么”的口吻撰写。
主要能力 命令文件格式:以 .md 文件存放于指定目录,基础命令无需 frontmatter,可通过 YAML frontmatter 配置 description(/help 中显示的简介)、allowed-tools(限定可用工具,如 Read, Write, Edit, Bash(git:*))、model(sonnet/opus/haiku)、argument-hint(参数提示)、disable-model-invocation(禁止模型以编程方式调用)等字段。 动态参数:$ARGUMENTS 捕获全部参数为单一字符串;$1、$2、$3 等捕获单个位置参数;可混合使用。 文件引用:使用 @ 语法在命令中引用文件内容,支持参数化路径(@$1)、多文件引用和静态文件引用。 Bash 内联执行:命令可内联执行 bash 命令以动态收集上下文(如 git 状态、环境信息),具体语法与示例见 skills.sh 相关参考文档中的 bash execution 部分。 命令组织:小规模命令可使用扁平结构;15 个以上或分类清晰时使用子目录命名空间结构,在 /help 中显示为 project:ci 等形式。 插件命令特性:插件命令可使用 ${CLAUDE_PLUGIN_ROOT} 环境变量引用插件内脚本、配置和模板,实现可移植路径;插件命令从 commands/ 目录自动发现,支持子目录命名空间。 多组件集成:命令可启动插件 agent、调用插件 skill、与 hook 协调,组合成多阶段工作流(如静态分析、深度审查、标准校验、模板化报告)。 校验模式:提供参数校验、文件存在性检查、插件资源校验等模式,便于在命令中处理缺失或非法输入。
使用方式 将命令 Markdown 文件放入 .claude/commands/(项目级,团队共享,/help 标记为 project)、~/.claude/commands/(个人级,所有项目可用,标记为 user)或插件的 commands/ 目录(标记为 plugin-name)。编写时以指令形式面向 Claude,使用 argument-hint 记录参数,按需声明 allowed-tools 与 model。
适用场景 团队标准化工作流(代码审查、测试、部署、文档生成)、个人跨项目工具、插件功能封装,以及需要组合 agent、skill、脚本的复杂多步骤流程。
限制与注意事项 Bash 执行应限定范围(如 Bash(git:) 而非 Bash())、避免破坏性操作并保持快速;文件引用需确保 Read 工具可用;命令未出现时检查目录、扩展名与格式并重启 Claude Code;参数问题检查 $1/$2 语法与 argument-hint 一致性;插件命令中 agent 需存在于 plugin/agents/、skill 需存在于 plugin/skills/。以上为资料所述内容,未提及收费、价格或平台支持等信息。