关于 command-creator
指导用户和 Agent 设计并创建可复用 Claude Code 斜杠命令的技能，涵盖命令位置、工作流模式、需求收集和命令文件编写。
主要功能
- 01选择项目或全局命令位置
- 02介绍可复用的工作流模式
- 03收集命令需求
- 04编写结构化命令指令
- 05提供参考示例和检查清单
适用场景
- 01将重复任务转为斜杠命令
- 02创建项目专用命令
- 03定义调用 Agent 或工具的命令
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/command-creator确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
README.mdreferences/best-practices.mdexamples.mdpatterns.md详细介绍
命令创建器
此技能指导如何创建 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 文件，包含：
---
description: Brief description shown in /help (required)
argument-hint: <placeholder> (optional, if command takes arguments)
---
# Command Title
[Detailed instructions for the agent to execute autonomously]
命令创建工作流
第 1 步：确定位置
自动检测合适的位置：
- 检查 Git 仓库状态：
git rev-parse --is-inside-work-tree 2>/dev/null - 默认位置：
- 如果位于 Git 仓库中 → 项目级：
.claude/commands/ - 如果不在 Git 仓库中 → 全局：
~/.claude/commands/
- 如果位于 Git 仓库中 → 项目级：
- 允许用户覆盖：
- 如果用户明确提到“全局”或“用户级” → 使用
~/.claude/commands/ - 如果用户明确提到“项目”或“项目级” → 使用
.claude/commands/
- 如果用户明确提到“全局”或“用户级” → 使用
继续之前，向用户说明所选位置。
第 2 步：展示命令模式
帮助用户了解不同的命令类型。加载 references/patterns.md，查看可用模式：
- 工作流自动化 - 分析 → 执行 → 报告（例如 submit-stack）
- 迭代修复 - 运行 → 解析 → 修复 → 重复（例如 ensure-ci）
- Agent 委派 - 上下文 → 委派 → 迭代（例如 create-implementation-plan）
- 简单执行 - 使用参数运行命令（例如 codex-review）
询问用户：“哪种模式最接近你想创建的命令？”这有助于明确讨论方向。
第 3 步：收集命令信息
向用户询问关键信息：
A. 命令名称和用途
询问：
- “命令应该叫什么？”（用于文件名）
- “这个命令的作用是什么？”（用于描述字段）
指南：
- 命令名称必须采用 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: <placeholder> - 必填参数使用
<尖括号> - 可选参数使用
[方括号]
C. 工作流步骤
询问：
- “这个命令应遵循哪些具体步骤？”
- “这些步骤应按什么顺序执行？”
- “应使用哪些工具或命令？”
收集以下方面的详细信息：
- 要执行的初步分析或检查
- 要采取的主要操作
- 如何处理结果
- 成功标准
- 错误处理方式
D. 工具限制与指导
询问：
- "此命令是否应使用任何特定的 Agent 或工具？"
- "是否有任何工具或操作需要避免？"
- "是否应读取任何特定文件以获取上下文？"
第 4 步：生成优化后的命令
使用面向 Agent 的指令创建命令文件。加载 references/best-practices.md，获取以下内容：
- 模板结构
- Agent 执行的最佳实践
- 写作风格指南
- 质量检查清单
核心原则：
- 使用祈使句/不定式形式（以动词开头的指令）
- 明确且具体
- 说明预期结果
- 提供具体示例
- 定义清晰的错误处理方式
第 5 步：创建命令文件
-
确定完整文件路径：
- 项目级：
.claude/commands/[command-name].md - 全局级：
~/.claude/commands/[command-name].md
- 项目级：
-
确保目录存在：
mkdir -p [directory-path] -
使用 Write 工具写入命令文件
-
与用户确认：
- 报告文件位置
- 概述该命令的功能
- 说明使用方法：
/command-name [arguments]
第 6 步：测试与迭代（可选）
如果用户希望测试：
- 建议测试：
You can test this command by running: /command-name [arguments] - 根据反馈随时进行迭代
- 按需更新文件以改进内容
快速提示
如需详细指导，请加载随附的参考资料：
- 设计命令工作流时，加载 references/patterns.md
- 加载 references/examples.md，查看现有命令的结构
- 定稿前加载 references/best-practices.md，以确保质量
需要牢记的常见模式：
- 对
pytest、pyright、ruff、prettier、make、gt命令使用 Bash 工具 - 使用 Task 工具调用子 Agent 处理专门任务
- 在继续之前，先检查特定文件（例如
.PLAN.md） - 立即标记待办事项为完成，不要批量标记
- 包含明确的错误处理指令
- 定义清晰的成功标准
总结
创建命令时：
- 确定位置（项目级还是全局级）
- 展示模式，以便框架化对话
- 收集信息（名称、用途、参数、步骤、工具）
- 生成优化后的命令，提供 Agent 可执行的指令
- 在合适位置创建文件
- 确认并按需迭代
重点是创建 Agent 能够自主执行的命令，包含清晰的步骤、明确的工具用法以及完善的错误处理。