command-creator

命令创建器

本技能指导创建 Claude Code 斜杠命令——可在 Claude Code 对话中通过 /command-name 调用的可复用工作流。

关于斜杠命令

斜杠命令是存储在 .claude/commands/（项目级）或 ~/.claude/commands/（全局/用户级）中的 Markdown 文件，调用时会展开为提示词。它们适用于：

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

何时使用此技能

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

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

捆绑资源

本技能包含参考文档以提供详细指导：

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

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

命令结构概述

每个斜杠命令都是一个 Markdown 文件，包含：

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

# 命令标题

[供代理自主执行的详细指令]

命令创建工作流

步骤 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）
• 代理委派 - 上下文 → 委派 → 迭代（例如 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. 参数

询问：

• “这个命令接受参数吗？”
• “参数是必需还是可选？”
• “参数应该代表什么？”

如果命令接受参数：

• 在 frontmatter 中添加 argument-hint: <placeholder>
• 使用 <angle-brackets> 表示必需参数
• 使用 [square-brackets] 表示可选参数

C. 工作流步骤

询问：

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

收集以下细节：

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

D. 工具限制和指导

询问：

• “这个命令应该使用特定的代理或工具吗？”
• “是否有应避免使用的工具或操作？”
• “是否应该读取特定文件以获取上下文？”

步骤 4：生成优化命令

创建包含代理优化指令的命令文件。加载 references/best-practices.md 以获取：

• 模板结构
• 代理执行的最佳实践
• 编写风格指南
• 质量检查清单

关键原则：

• 使用祈使句/不定式形式（动词优先的指令）
• 明确且具体
• 包含预期结果
• 提供具体示例
• 定义清晰的错误处理

步骤 5：创建命令文件

1. 确定完整文件路径：

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

2. 确保目录存在：

   mkdir -p [目录路径]
   

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

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 以确保质量

要记住的常见模式：

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

总结

创建命令时：

1. 检测位置（项目级 vs 全局）
2. 展示模式以框定对话
3. 收集信息（名称、用途、参数、步骤、工具）
4. 生成优化命令，包含代理可执行的指令
5. 创建文件到适当位置
6. 确认并根据需要迭代

专注于创建代理可以自主执行的命令，具有清晰的步骤、明确的工具使用和适当的错误处理。