命令创建器

此技能指导你创建Claude Code斜杠命令——这些是可复用的工作流程，在Claude Code对话中可通过

/command-name

调用。

关于斜杠命令

斜杠命令是存储在

.claude/commands/

（项目级）或

~/.claude/commands/

（全局/用户级）的Markdown文件，调用时会展开为提示词。它们非常适合：

重复性工作流（代码审查、PR提交、CI修复）
需要一致性的多步骤流程
Agent委托模式
项目特定的自动化

何时使用此技能

当用户出现以下情况时，调用此技能：

要求“创建命令”或“制作斜杠命令”
希望自动化重复性工作流
需要将一致的流程文档化以便复用
说“我一直在做X，我们能为此制作一个命令吗？”
想要创建项目特定或全局命令

附带资源

此技能包含参考文档，供你获取详细指导：

references/patterns.md - 命令模式（工作流自动化、迭代修复、Agent委托、简单执行）
references/examples.md - 完整源码的真实命令示例（submit-stack、ensure-ci、create-implementation-plan）
references/best-practices.md - 质量检查表、常见陷阱、编写指南、模板结构

创建命令时，可根据需要加载这些参考文档，以了解模式、查看示例或确保质量。

命令结构概述

每个斜杠命令都是一个Markdown文件，结构如下：

markdown

---
description: 显示在/help中的简短描述（必填）
argument-hint: <占位符>（可选，如果命令接受参数）
---

# 命令标题

[供Agent自主执行的详细说明]

命令创建工作流

步骤1：确定存储位置

自动检测合适的位置：

检查Git仓库状态：

git rev-parse --is-inside-work-tree 2>/dev/null

默认位置：
- 如果在Git仓库内 → 项目级：
```
.claude/commands/
```
- 如果不在Git仓库内 → 全局：
```
~/.claude/commands/
```
允许用户覆盖：
- 如果用户明确提到“global”或“user-level” → 使用
```
~/.claude/commands/
```
- 如果用户明确提到“project”或“project-level” → 使用
```
.claude/commands/
```

在继续之前，将选定的位置告知用户。

步骤2：展示命令模式

帮助用户了解不同的命令类型。加载references/patterns.md查看可用模式：

工作流自动化 - 分析 → 执行 → 报告（例如submit-stack）
迭代修复 - 运行 → 解析 → 修复 → 重复（例如ensure-ci）
Agent委托 - 上下文 → 委托 → 迭代（例如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. 参数

询问：

“这个命令是否接受参数？”
“参数是必填还是可选？”
“参数代表什么内容？”

如果命令接受参数：

在前置元数据中添加
```
argument-hint: <占位符>
```
使用
```
<尖括号>
```
表示必填参数
使用
```
[方括号]
```
表示可选参数

C. 工作流步骤

询问：

“这个命令应该遵循哪些具体步骤？”
“步骤的执行顺序是什么？”
“应该使用哪些工具或命令？”

收集以下细节：

要执行的初始分析或检查
主要操作
如何处理结果
成功标准
错误处理方式

D. 工具限制与指导

询问：

“这个命令是否应该使用特定的Agent或工具？”
“是否有任何工具或操作是需要避免的？”
“它是否需要读取特定文件以获取上下文？”

步骤4：生成优化的命令

创建包含Agent优化执行说明的命令文件。加载references/best-practices.md获取以下内容：

模板结构
Agent执行的最佳实践
写作风格指南
质量检查表

核心原则：

使用祈使/不定式形式（以动词开头的说明）
明确且具体
包含预期结果
提供具体示例
定义清晰的错误处理

步骤5：创建命令文件

确定完整文件路径：

项目级：
```
.claude/commands/[command-name].md
```
全局级：
```
~/.claude/commands/[command-name].md
```

确保目录存在：
bash
```
mkdir -p [directory-path]
```
使用Write工具写入命令文件
与用户确认：
- 告知文件位置
- 总结命令的作用
- 说明使用方式：
```
/command-name [arguments]
```

步骤6：测试与迭代（可选）

如果用户想要测试：

建议测试：

你可以通过运行以下命令测试此命令：/command-name [arguments]

随时根据反馈进行迭代
根据需要更新文件以优化内容

快速提示

如需详细指导，请加载附带的参考文档：

设计命令工作流时，加载references/patterns.md
查看现有命令结构时，加载references/examples.md
最终确定前，加载references/best-practices.md以确保质量

需要记住的常见模式：

对
```
pytest
```
、
```
pyright
```
、
```
ruff
```
、
```
prettier
```
、
```
make
```
、
```
gt
```
命令使用Bash工具
使用Task工具调用子Agent以执行专业任务
先检查特定文件（例如
```
.PLAN.md
```
），再继续执行后续步骤
立即标记待办事项为完成，而非批量处理
包含明确的错误处理说明
定义清晰的成功标准

总结

创建命令时：

检测位置（项目级 vs 全局级）
展示模式以引导对话
收集信息（名称、用途、参数、步骤、工具）
生成优化命令，包含Agent可自主执行的说明
在合适位置创建文件
确认并按需迭代

重点创建Agent可自主执行的命令，包含清晰的步骤、明确的工具使用说明和完善的错误处理机制。

command-creator

NPX安装

标签

SKILL.md 内容（中文）