Claude Code 自定义命令
解释 Claude Code custom commands、slash commands 与 skills 的关系，以及如何维护可复用工作流。
自定义命令让你不用每次重复输入同一段工作流提示。当前 Claude Code 的更大方向是 skills：用 Markdown 包装说明、示例、模板和辅助材料，比单个命令更适合团队复用。
最后核查：2026 年 5 月 24 日。很多旧教程仍叫 custom slash commands；当前官方文档更强调 skills，同时保留 command 风格的使用方式。
短答案
简单快捷入口用 command；有步骤、示例、校验或团队规则的复用流程，用 skill。
Commands 和 Skills 怎么选
| 需求 | 建议 | 原因 |
|---|---|---|
| 简单快捷提示，例如 review diff | Custom command | 低成本，容易读。 |
| 带 checklist 的复用流程 | Skill | 结构和说明更清楚。 |
| 团队流程、模板、示例 | Skill | 可以包含辅助文件。 |
| 外部工具能力 | MCP server 或 plugin | Command 本身不会提供外部工具。 |
| 每次会话都要遵守的项目规则 | CLAUDE.md | 应该作为上下文加载，而不是手动调用。 |
示例
简单 command：
# Review the current diff
Check the current git diff for correctness, missing tests, and risky changes.
Lead with concrete findings and file references.复杂 skill：
.claude/skills/release-check/
SKILL.md
checklist.md
examples/只要流程开始需要模板、示例、验证或多步骤说明，就不要继续塞进一个超长 command。
维护规则
- 名称要直观，团队成员一看就知道什么时候用。
- 稳定项目事实放
CLAUDE.md，不要在每个 command 里重复。 - 不要在 command 里隐藏危险权限。
- 先在小 diff 上测试，再用于 release 分支。
- 旧 command 被 skill 覆盖后及时删除。
常见错误
| 错误 | 更好的做法 |
|---|---|
| 300 行 command 文件 | 拆成 skill 和辅助文档。 |
| 写死本机路径 | 用项目相对路径或 CLAUDE.md。 |
| 让 Claude 跳过 review | 保留 review 和 permission gate。 |
| 复制一大段官方文档 | 链接官方文档，只保留团队差异。 |