name: 创建命令 description: | 遵循最佳实践创建新的Claude Code斜杠命令。指导命令结构、命名、参数和前置元数据的使用。当用户想要创建命令、构建斜杠命令或询问命令最佳实践时使用。
创建命令
使用文档化的最佳实践指导Claude Code斜杠命令的创建。
快速开始
对于新命令：
- 询问用户命令的目的和需要的参数
- 使用适当的模板生成
- 根据检查清单进行验证
对于审查现有命令：
- 读取命令文件
- 根据reference.md中的反模式进行检查
- 报告问题并提供修复建议
工作流程：创建新命令
进度：
- [ ] 收集需求（目的、参数、范围）
- [ ] 选择模板（基础、带参数、工作流）
- [ ] 生成命令文件
- [ ] 根据检查清单验证
步骤1：收集需求
使用AskUserQuestion询问用户：
- 这个命令应该做什么？（目的）
- 需要参数吗？（无、单个、多个）
- 项目还是个人使用？（范围）
步骤2：选择模板
| 类型 | 模板 | 使用时机 |
|---|---|---|
| 基础 | templates/basic.md | 无参数，简单提示 |
| 带参数 | templates/with-args.md | 单个或多个参数 |
| 工作流 | templates/workflow.md | 与技能/智能体集成 |
步骤3：生成命令
在适当的位置创建：
.claude/commands/- 项目命令（git跟踪）~/.claude/commands/- 个人命令（仅限本机）
步骤4：验证
完成前运行检查清单：
验证检查清单：
- [ ] 名称：仅使用小写字母和连字符
- [ ] 名称：描述性，推荐动词-名词格式
- [ ] 描述：解释命令的功能
- [ ] 参数：如果使用，用argument-hint记录
- [ ] 提示：清晰、可操作的指令
- [ ] 工具：如果需要，声明allowed-tools
命名规则
格式：动词-名词或动作（小写，连字符）
修复问题审查pr运行测试优化
约束：
- 仅限小写字母、数字、连字符
- 无空格或下划线
- 保持简洁（1-3个单词）
命令文件格式
---
description: 帮助中显示的简要说明
allowed-tools:
- Bash(bash:*)
- WebSearch
argument-hint: "参数名称"
---
您的命令提示在此处。
使用$ARGUMENTS获取所有参数，或$1、$2获取位置参数。
参数语法
| 语法 | 用法 | 示例 |
|---|---|---|
$ARGUMENTS |
所有参数作为一个字符串 | /cmd foo bar → foo bar |
$1, $2 |
位置参数 | /cmd foo bar → $1=foo, $2=bar |
@file |
包含文件内容 | 审查 @src/main.ts |
前置元数据选项
| 字段 | 目的 | 必需 |
|---|---|---|
description |
在帮助中显示，启用自动调用 | 推荐 |
allowed-tools |
命令可以使用的工具 | 如果使用工具 |
argument-hint |
记录预期参数 | 如果有参数 |
model |
使用的特定模型 | 可选 |
示例：基础命令
---
description: 运行所有测试并报告失败
allowed-tools:
- Bash(npm:*)
---
运行测试套件并总结结果：
1. 执行 `npm test`
2. 如果有失败，显示失败测试及上下文
3. 为常见问题提供修复建议
详见reference.md获取详细的最佳实践和反模式。