关于 command-creator
一个用于创建 Claude Code 自定义斜杠命令的技能，命令以带 YAML 前置元数据的 Markdown 文件编写。它会引导用户明确用途、选择范围与路径，并检查结果。
主要功能
- 01明确命令用途和输入
- 02选择项目或用户范围
- 03创建带 YAML 前置元数据的 Markdown
- 04配置参数与允许使用的工具
- 05检查命令结构和存放路径
适用场景
- 01创建团队共享的项目命令
- 02设置个人可复用命令
- 03定义可接收参数的命令
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/command-creator确认已加载。
详细介绍
命令创建器
创建结构规范且遵循最佳实践的 Claude Code 自定义斜杠命令。
了解命令
Claude Code 命令是带有 YAML frontmatter 的 Markdown 文件，用于定义可通过 /command-name 调用的可复用工作流。命令的位置取决于其作用范围：
- 项目级：项目根目录下的
.claude/commands/（通过 git 共享） - 用户级：
~/.claude/commands/（个人使用，在任何地方都可用） - 分类命令：在子目录中嵌套存放，以便进行命名空间划分（例如，
gh/review-pr.md会成为/gh:review-pr）
流程
1. 明确意图
在编写任何内容之前，先了解：
- 命令应执行什么操作？（单一且明确的目的）
- 谁会使用它——仅当前用户，还是整个团队？（决定使用项目级还是用户级）
- 是否需要参数？需要什么类型的参数？
- 需要访问哪些工具？
- 它属于哪个类别？（例如，GitHub 使用
gh，Claude Code 元命令使用cc）
2. 编写命令
每个命令文件都遵循以下结构：
---
description: Brief description shown in command list
argument-hint: [expected-arguments]
allowed-tools: Tool1, Tool2, Bash(prefix:*)
---
# Command Name
What this command does and when to use it.
## Process:
Step-by-step instructions for the agent to follow.
## Your Task:
Act on "$ARGUMENTS" following these guidelines.
Frontmatter 字段
| 字段 | 必填 | 用途 |
|---|---|---|
description | 是 | 列出命令时显示的简短说明 |
argument-hint | 否 | 对预期参数的提示（在自动补全中显示） |
allowed-tools | 否 | 限制命令可使用的工具 |
关键约定
$ARGUMENTS会被替换为用户在命令名称后输入的内容。请务必在“你的任务”部分引用它，以便命令根据用户输入执行操作。allowed-tools使用匹配模式：精确名称（Read、Write），或适用于 Bash 的前缀 glob（Bash(git:*)、Bash(npm:*)）。- 让命令专注且用途单一——一个命令只做一件事。
- 使用祈使句编写指令（“分析代码”，而不是“你应该分析代码”）。
- 提供具体示例，说明如何使用以及预期行为。
3. 选择合适的位置
| 作用范围 | 路径 | 适用场景 |
|---|---|---|
| 项目（共享） | .claude/commands/ | 团队工作流、项目专属任务 |
| 项目（分类） | .claude/commands/<category>/ | 分组命令（例如，gh/、db/） |
| 用户（个人） | ~/.claude/commands/ | 个人效率工具、跨项目工具 |
4. 验证
创建命令文件后：
- 验证 YAML frontmatter 是否能正确解析（没有语法错误）
- 确认文件位于正确的目录中
- 如果命令接受输入，检查是否引用了
$ARGUMENTS - 确保
allowed-tools包含命令所需的所有工具
示例：简单命令
---
description: Review a pull request with detailed analysis
argument-hint: [PR-number-or-URL]
allowed-tools: Bash(gh:*), Read, Grep, Glob
---
# Review PR
Perform a thorough code review of a GitHub pull request.
## Process:
1. Fetch PR details and diff using `gh pr view` and `gh pr diff`
2. Read changed files for full context
3. Analyze changes for:
- Correctness and potential bugs
- Code style consistency
- Missing tests or edge cases
- Security concerns
4. Provide a structured review summary
## Your Task:
Review PR "$ARGUMENTS" following these guidelines. If no PR number is given,
use `gh pr list` to show recent PRs and ask which one to review.
最佳实践
- 使用描述性名称：文件名会成为命令名称——应清晰易懂（使用
fix-issue.md，而不是fi.md） - 妥善处理参数：始终处理
$ARGUMENTS为空的情况 - 尽量减少工具权限：仅在
allowed-tools中列出命令实际需要的工具 - 遵循现有模式：查看同一目录中的其他命令，了解其约定
- 发布前测试：使用不同的输入试运行命令，验证其是否正常工作
你的任务
根据“$ARGUMENTS”创建一个新命令：
- 如果目的不明确，请提出澄清问题
- 确定合适的位置和类别
- 按照规范结构创建命令文件
- 说明创建的内容及其使用方法
评论
支持 Markdown