command-creator

命令创建器

此技能指导如何创建 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 步：确定位置

自动检测合适的位置：

1. 检查 Git 仓库状态：git rev-parse --is-inside-work-tree 2>/dev/null
2. 默认位置：
   • 如果位于 Git 仓库中 → 项目级：.claude/commands/
   • 如果不在 Git 仓库中 → 全局：~/.claude/commands/
3. 允许用户覆盖：
   • 如果用户明确提到“全局”或“用户级” → 使用 ~/.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 步：创建命令文件

1. 确定完整文件路径：

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

2. 确保目录存在：

   mkdir -p [directory-path]
   

3. 使用 Write 工具写入命令文件

4. 与用户确认：

   • 报告文件位置
   • 概述该命令的功能
   • 说明使用方法：/command-name [arguments]

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

如果用户希望测试：

1. 建议测试：You can test this command by running: /command-name [arguments]
2. 根据反馈随时进行迭代
3. 按需更新文件以改进内容

快速提示

如需详细指导，请加载随附的参考资料：

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

需要牢记的常见模式：

• 对 pytest、pyright、ruff、prettier、make、gt 命令使用 Bash 工具
• 使用 Task 工具调用子 Agent 处理专门任务
• 在继续之前，先检查特定文件（例如 .PLAN.md）
• 立即标记待办事项为完成，不要批量标记
• 包含明确的错误处理指令
• 定义清晰的成功标准

总结

创建命令时：

1. 确定位置（项目级还是全局级）
2. 展示模式，以便框架化对话
3. 收集信息（名称、用途、参数、步骤、工具）
4. 生成优化后的命令，提供 Agent 可执行的指令
5. 在合适位置创建文件
6. 确认并按需迭代

重点是创建 Agent 能够自主执行的命令，包含清晰的步骤、明确的工具用法以及完善的错误处理。