用途:为 Claude Code 创建自定义斜杠命令,把常用提示词与工作流固化为可复用的命令模板。
主要能力:支持项目命令(.claude/commands/name.md,团队共享、可提交 git)与个人命令(~/.claude/commands/name.md);支持参数 $ARGUMENTS 或 $1、$2 位置参数;支持 bash 执行 [execute: command](需 allowed-tools: Bash(...));支持文件引用 @path/to/file;支持 YAML frontmatter 配置 description、allowed-tools、argument-hint、model 等。
使用方式:按需求收集、选择作用域、设计结构、实现、测试、迭代六阶段进行。创建文件时文件名(去掉 .md)即命令名,例如 touch .claude/commands/your-command.md。命令内可用 [execute: git branch --show-current] 注入上下文,用 @$1 引用文件。测试时用 /help 确认命令出现,再以 /your-command arg1 arg2 验证参数与执行效果。
适用场景:代码分析、Git 工作流、代码生成、深度分析等重复性任务;只读分析可限制为 Read、Grep、Glob,Git 操作可限制为 Bash(git:*)。
限制与注意:bash 执行必须声明 allowed-tools: Bash(...) 并使用反引号语法;文件引用需 @ 前缀且路径存在;命令不出现于 /help 通常因位置、扩展名或文件名问题;参数未替换多因占位符拼写错误。斜杠命令为用户手动调用,与自动发现的 Skills 不同。建议从简单版本开始,逐步增加功能并测试。