Command Creator

斜杠命令是位于 .claude/commands/（项目级）或 ~/.claude/commands/（全局级）目录下的 Markdown 文件，调用时会扩展为提示内容。

命令结构

---
description: /help 中显示的简要说明（必填）
argument-hint: <required> 或 [optional]（若需参数）
---

# 命令标题

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

创建流程

步骤 1：确定位置

1. 检查是否在 Git 仓库中：git rev-parse --is-inside-work-tree
2. 默认规则：有 Git 仓库 → .claude/commands/，无 Git 仓库 → ~/.claude/commands/
3. 若用户明确指定“全局”或“项目”，则覆盖默认路径

在继续前报告选定的位置。

步骤 2：识别模式

加载 [references/patterns.md](references/patterns.md) 并提供以下选项：

提问：“哪一个模式最符合你的需求？”

步骤 3：收集信息

A. 名称与用途

• “命令应叫什么名字？”（使用 kebab-case 格式：my-command）
• “它具体做什么？”（用于 description 字段）

B. 参数

• “是否需要参数？是必填还是可选？”
• 必填参数：<placeholder>，可选参数：[placeholder]

C. 工作流步骤

• “它应遵循哪些具体步骤？”
• “应使用哪些工具或命令？”

D. 限制条件

• “是否有必须使用或避免的工具？”
• “是否有需要读取以获取上下文的文件？”

步骤 4：生成命令

加载 [references/best-practices.md](references/best-practices.md) 获取：

• 模板结构
• 写作风格（使用祈使句）
• 质量检查清单

关键原则：

• 使用祈使句：如“运行 X”，而非“你应该运行 X”
• 表述明确：如“运行 make lint”，而非“检查错误”
• 包含预期结果
• 明确错误处理方式
• 说明成功标准

步骤 5：创建文件

mkdir -p [directory-path]

编写命令文件。报告以下内容：

• 文件位置
• 命令功能说明
• 使用方法：/command-name [args]

步骤 6：测试（可选）

建议：“使用 /command-name [args] 进行测试”

根据反馈迭代优化。

编写指南

使用祈使句（动词开头）：

• ✅ “运行 git status”
• ❌ “你应该运行 git status”

具体明确，避免模糊：

• ✅ “运行 make lint 以检查错误”
• ❌ “检查错误”

包含预期结果：

• ✅ “运行 git status —— 应显示已修改的文件”
• ❌ “运行 git status”

使用真实示例：

• ✅ git commit -m "Add OAuth2 authentication"
• ❌ git commit -m "foo bar"

命令模式速查表

工作流自动化

1. 检查 .PLAN.md 是否存在
2. 分析 git status/diff
3. 执行相应操作
4. 输出结果报告

迭代修复

1. 运行 make all-ci（最多 10 次迭代）
2. 按类别解析错误
3. 应用针对性修复
4. 重复直到成功或卡住

代理委派

1. 提供上下文信息
2. 使用 Task 工具调用子代理
3. 根据用户反馈进行迭代
4. 经确认后保存输出结果

更多完整示例请参见 [references/examples.md](references/examples.md)。

质量检查清单

在最终确认前，请确保：

• [ ] 命令名称为 kebab-case 格式（如 my-command，而非 my_command）
• [ ] description 字段具有行动导向
• [ ] 步骤编号清晰且具体
• [ ] 工具使用方式明确指出
• [ ] 错误处理机制已定义
• [ ] 成功标准已说明
• [ ] 使用了祈使句形式

禁止事项

• 命令名称中使用下划线（应使用连字符）
• 编写模糊指令（如“修复错误”）
• 忽略错误处理
• 使用第二人称（如“你应该…”）
• 在未测试的情况下创建命令
• 不明确说明成功标准