命令创建器Skill command-creator

---

name: 命令创建器 description: 此技能应在创建 Claude Code 斜杠命令时使用。当用户请求“创建命令”、“制作斜杠命令”、“添加命令”或将工作流程记录为可重用命令时使用。对于创建优化、可代理执行的斜杠命令至关重要，具有适当的结构和最佳实践。

命令创建器

此技能指导创建 Claude Code 斜杠命令——可在 Claude Code 对话中用 /命令名称 调用的可重用工作流程。

关于斜杠命令

斜杠命令是存储在 .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: <占位符>（可选，如果命令接受参数）
---

# 命令标题

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

命令创建工作流程

步骤 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: <占位符>
• 使用 <尖括号> 表示必需参数
• 使用 [方括号] 表示可选参数

C. 工作流程步骤

询问：

• “此命令应遵循哪些具体步骤？”
• “它们应按什么顺序发生？”
• “应使用什么工具或命令？”

收集有关以下内容的细节：

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

D. 工具限制和指导

询问：

• “此命令应使用任何特定代理或工具吗？”
• “有它应避免的任何工具或操作吗？”
• “它应为上下文读取任何特定文件吗？”

步骤 4：生成优化命令

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

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

关键原则：

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

步骤 5：创建命令文件

1. 确定完整文件路径：

   • 项目：.claude/commands/[命令名称].md
   • 全局：~/.claude/commands/[命令名称].md

2. 确保目录存在：

   mkdir -p [目录路径]
   

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

4. 与用户确认：

   • 报告文件位置
   • 总结命令的功能
   • 解释如何使用：/命令名称 [参数]

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

如果用户想要测试：

1. 建议测试：您可以通过运行测试此命令：/命令名称 [参数]
2. 准备根据反馈迭代
3. 根据需要更新文件以改进

快速提示

如需详细指导，加载捆绑参考：

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

记住的常见模式：

• 对 pytest、ty、ruff、prettier、make、gt 命令使用 devrun 代理
• 对专业代理（implementation-planner、plan-executors）使用 Task 工具
• 在继续前先检查特定文件（例如，.PLAN.md）
• 立即标记待办事项完成，而非批量处理
• 包括明确的错误处理指令
• 定义清晰的成功标准

总结

创建命令时：

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

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