Slash Commands 参考指南

概览

Slash command 是你在 Claude 的交互式会话中用来控制行为的快捷方式，主要分为几类：

• 内置命令：Claude Code 自带，例如 /help、/clear、/model
• Skills：你自己定义的命令，基于 SKILL.md 文件，例如 /optimize、/pr
• 插件命令：来自已安装插件的命令，例如 /frontend-design:frontend-design
• MCP prompts：来自 MCP server 的命令，例如 /mcp__github__list_prs

注意：自定义 slash command 已经合并进 Skills。.claude/commands/ 仍然可用，但现在更推荐使用 .claude/skills/。两者都会创建 /command-name 形式的快捷命令。完整参考请见 Skills 指南。

命令架构

    graph TD
    A["用户输入：/command-name"] --> B{"命令类型？"}
    B -->|内置| C["执行内置命令"]
    B -->|Skill| D["加载 SKILL.md"]
    B -->|插件| E["加载插件命令"]
    B -->|MCP| F["执行 MCP Prompt"]

    D --> G["解析 Frontmatter"]
    G --> H["替换变量"]
    H --> I["执行 Shell 命令"]
    I --> J["发送给 Claude"]
    J --> K["返回结果"]
  

常用内置命令

Claude Code 目前提供 55+ 个内置命令和多个内置 Skills。你可以在 Claude Code 中输入 / 查看全部，也可以输入 / 后继续键入字母进行筛选。

内置 Skills

以下 Skills 随 Claude Code 一起提供，调用方式和 slash command 一样：

自定义命令（现已归入 Skills）

自定义 slash command 已经合并到 Skills。两种方式都可以通过 /command-name 调用： 这里列出commands文件夹只是说明以前有这么个事儿，不推荐使用。

把自定义命令做成 Skill

创建一个包含 SKILL.md 的目录：

mkdir -p .claude/skills/my-command

文件： .claude/skills/my-command/SKILL.md

---
name: my-command
description: 这个命令的作用，以及何时使用它
---

# 我的命令

当该命令被触发时，Claude 需要遵循的说明。

1. 第一步
2. 第二步
3. 第三步

Frontmatter 参考

参数

命令可以接收参数：

使用 $ARGUMENTS 接收全部参数：

---
name: fix-issue
description: 根据编号修复 GitHub issue
---

按团队编码规范修复 #$ARGUMENTS

调用 /fix-issue 123 时，$ARGUMENTS 会变成 123。

使用 $0、$1 等接收单个参数：

---
name: review-pr
description: 按优先级审查 PR
---

审查 #$0，优先级为 $1

调用 /review-pr 456 high 时，$0="456"，$1="high"。

用 Shell 命令注入动态上下文

在 prompt 发送前，可用 !`command` 先执行 shell 命令：

---
name: commit
description: 使用上下文创建 git commit
allowed-tools: Bash(git *)
---

## 上下文

- 当前 git 状态：!`git status`
- 当前 diff：!`git diff HEAD`
- 当前分支：!`git branch --show-current`
- 最近提交：!`git log --oneline -5`

## 你的任务

根据以上变更，创建一个 git commit。

文件引用

使用 @ 引用文件内容：

审查 @src/utils/helpers.js 中的实现
比较 @src/old-version.js 和 @src/new-version.js

插件命令

插件可以提供自定义命令：

/plugin-name:command-name

如果没有命名冲突，也可以直接使用 /command-name。

示例：

/frontend-design:frontend-design
/commit-commands:commit

MCP Prompts 作为命令

MCP servers 可以把 prompt 暴露成 slash command：

/mcp__<server-name>__<prompt-name> [arguments]

示例：

/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

MCP 权限语法

在权限中控制 MCP server 访问：

• mcp__github - 访问整个 GitHub MCP server
• mcp__github__* - 通配符访问全部工具
• mcp__github__get_issue - 访问某个特定工具

命令生命周期

    sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant FS as File System
    participant CLI as Shell/Bash

    User->>Claude: 输入 /optimize
    Claude->>FS: 搜索 .claude/skills/ 和 .claude/commands/
    FS-->>Claude: 返回 optimize/SKILL.md
    Claude->>Claude: 解析 frontmatter
    Claude->>CLI: 执行 !`command` 替换
    CLI-->>Claude: 命令输出
    Claude->>Claude: 替换 $ARGUMENTS
    Claude->>User: 处理 prompt
    Claude->>User: 返回结果
  

举几个栗子

这些示例命令可以作为 skill 或旧式命令安装。

1. /generate-api-docs - API 文档生成器

从源码生成完整的 API 文档。

用法：

/generate-api-docs

文件： generate-api-docs.md

2. /commit - 带上下文的 Git Commit

基于仓库中的动态上下文创建 git commit。

用法：

/commit [可选说明]

文件： commit.md

3. /push-all - 暂存、提交并推送

会先暂存所有改动，再提交，并带安全检查地推送到远端。

用法：

/push-all

文件： push-all.md

安全检查：

• 密钥文件：.env*、*.key、*.pem、credentials.json
• API Keys：识别真实 key 与占位符
• 大文件：未使用 Git LFS 且大于 10MB
• 构建产物：node_modules/、dist/、__pycache__/

安装

作为 Skills（推荐）

复制到你的 skills 目录：

# 创建 skills 目录
mkdir -p .claude/skills

# 对每个命令文件，创建一个 skill 目录
for cmd in optimize pr commit; do
  mkdir -p .claude/skills/$cmd
  cp 01-slash-commands/$cmd.md .claude/skills/$cmd/SKILL.md
done

今天就创建你自己的命令

Skill 模板（推荐）

创建 .claude/skills/my-command/SKILL.md：

---
name: my-command
description: 这个命令做什么。用于 [触发条件]。
argument-hint: [可选参数]
allowed-tools: Bash(npm *), Read, Grep
---

# Command Title

## 上下文

- 当前分支：!`git branch --show-current`
- 相关文件：@package.json

## 指令

1. 第一步
2. 第二步，参数：$ARGUMENTS
3. 第三步

## 输出格式

- 如何格式化回复
- 需要包含什么

仅用户可调用的命令（无自动触发）

对于带副作用、Claude 不应自动触发的命令：

---
name: deploy
description: 部署到生产环境
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---

将应用部署到生产环境：

1. 运行测试
2. 构建应用
3. 推送到部署目标
4. 验证部署

最佳实践

故障排查

找不到命令

解决办法：

• 检查文件是否位于 .claude/skills/<name>/SKILL.md 或 .claude/commands/<name>.md
• 确认 frontmatter 中的 name 与预期命令名一致
• 重启 Claude Code 会话
• 运行 /help 查看可用命令

命令没有按预期执行

解决办法：

• 补充更具体的指令
• 在 skill 文件中加入示例
• 如果使用 bash 命令，检查 allowed-tools
• 先用简单输入测试

Skill 与 Command 冲突

如果同名同时存在，skill 优先。删除其中一个或重命名即可。

常用内置命令参考

Claude Code 目前提供 55+ 个内置命令和 5 个内置 Skills。你可以在 Claude Code 中输入 / 查看全部，也可以输入 / 后继续键入字母进行筛选。。其他命令使用claude –help可以获取

相关指南

• Skills - 完整的 Skills 参考
• Memory - 带 CLAUDE.md 的持久上下文
• Subagents - 委派式 AI agents
• Plugins - 打包好的命令集合
• Hooks - 事件驱动自动化

其他资源

• 官方交互模式文档 - 内置命令参考
• 官方 Skills 文档 - 完整 Skills 参考
• CLI Reference - 命令行选项

最后更新: 2026 年 7 月 7 日