内容来源：alexop.dev。https://alexop.dev/posts/claude-code-slash-commands-guide/
原题：Claude Code Slash Commands: A Complete Guide (2026)
原发布时间：2025-11-22
使用斜杠命令把 Claude Code 从聊天机器人改造成确定性执行引擎。本文介绍技术配置，并提供一套自动完成整个功能生命周期的“完整闭环”工作流。
兼容性说明（核对于 2026-07-20）：本文使用
.claude/commands/；当前 Skills 文档建议新工作使用.claude/skills/<name>/SKILL.md，同时保留命令目录以兼容旧配置。文中的自定义/branch用于创建 Git 分支，但当前 Claude Code 也内置了用于分叉对话的/branch。建议把自定义命令改名为/git-branch等名称，避免歧义。下文保留来源原始命令。
我一直在浪费时间。每条提交消息、每个分支名称、每份 PR 描述，都要反复输入相同内容。
后来，我发现了 Claude Code 的斜杠命令。现在，输入 /commit，它就会替我编写提交消息；输入 /branch "add dark mode"，它会创建 feat/add-dark-mode；输入 /pr，它会根据提交生成完整 PR 描述。
本文会展示如何构建同样的工作流。先介绍斜杠命令的运行方式，再搭建一套自动处理整个 Git 生命周期的完整系统。
💡 延伸阅读
斜杠命令只是 Claude Code 体系的一部分。要了解包括 MCP、Hooks、子智能体和 Skills 在内的完整图景，请阅读我的 Claude Code 功能技术栈完整指南。
/branch 命令会自动创建功能分支
📢 前置条件
需要安装 Git 和 GitHub CLI（
gh）。macOS 可以运行brew install gh，其他平台请访问 cli.github.com。再运行gh auth login完成身份验证。没有
gh，/pr和/fix-pipeline等命令将无法工作。
必须了解的两件事
开始构建工作流前，需要先理解两项功能。
执行 Bash 命令
在命令文件中写入 !git status，Claude 会先运行命令、捕获输出，再把结果注入提示词。AI 会在开始思考前看到真实结果。
这就是 /commit 知道你修改了什么的原因。它会自动运行 !git diff。更多细节请参阅官方文档。
选择模型
修复一个缺失的分号不需要能力最强的模型。
Claude Code 允许在 Frontmatter 中选择模型：
• sonnet——适合复杂推理，默认选择
• haiku——速度快、成本低
加入 model: haiku 后，命令几乎可以瞬间运行。
命令结构
斜杠命令是存放在 .claude/commands/ 项目目录或 ~/.claude/commands/ 个人目录中的 Markdown 文件。文件名会成为命令名，例如 commit.md 对应 /commit。
└── my-project/
├── .claude/
│ ├── settings.json 项目设置
│ └── commands/
│ ├── branch.md /branch
│ ├── commit.md /commit
│ ├── pr.md /pr
│ └── lint.md /lint
├── src
└── package.json
下面是一个完整示例：
---
description: 使用符合约定的消息创建 Git Commit
allowed-tools: Bash(git add:*), Bash(git commit:*)
argument-hint: [message]
model: haiku
---
# 提交修改
<git_diff>
!`git diff --cached`
</git_diff>
创建符合 Conventional Commits 规范的提交消息。
如果提供了 $ARGUMENTS，就将其用作提交消息。
输入 / 时，斜杠命令会出现在自动补全中
Frontmatter 选项
| 选项 | 用途 | 默认值 |
|---|---|---|
description |
在 /help 中显示的简短说明 |
提示词第一行 |
allowed-tools |
命令可以使用的工具 | 继承当前对话 |
model |
使用的模型：sonnet、haiku 或完整模型 ID |
继承当前对话 |
argument-hint |
在自动补全中显示预期参数 | 无 |
参数
使用 $ARGUMENTS 获取传给命令的全部内容：
创建名为 $ARGUMENTS 的分支
存在多个参数时，使用 $1、$2 等位置参数：
---
argument-hint: [pr-number] [priority]
---
以优先级 $2 审查 PR #$1。
文件引用
使用 @ 前缀加入文件内容：
审查 @src/utils/helpers.js 中的实现
完整工作流
我用自定义命令取代了手工 Git 操作，它们都放在 .claude/commands/ 中。下面是如何推动一项功能从开始走到合并。
/branch：开始任务
输入 /branch "implement dark mode toggle" 后，Claude 会切换到 Main、拉取最新代码，再创建 feat/dark-mode-toggle。从此不必再思考命名约定。
/lint：提交前修复问题
输入 /lint 后，它会运行带自动修复的 Linter；如果仍有错误，Claude 会继续修复。为了提高速度，它使用 Haiku，大约二十秒即可完成。
/vitest：运行单元测试
输入 /vitest 后，它会运行测试套件并修复失败。提示词要求 Claude 修改代码，而不是修改测试，因为实现应当符合预期行为。
/commit：保存工作
输入 /commit 后，Claude 会分析 Diff、生成 Conventional Commit 消息并提交。它还会查看最近的提交，以匹配项目风格。
/push：一步完成提交和推送
输入 /push 后，它会暂存全部修改、生成提交消息、提交并推送。这是我最常使用的命令：只输入一个词，代码就会出现在 GitHub 上。
/fix-pipeline：修复失败的 CI 测试
输入 /fix-pipeline 后，它会通过 gh 获取失败日志、分析错误并修复。调试需要推理，因此使用 Sonnet。提示词还包含护栏：Claude 必须先阅读真实错误，才能提出修复。
/pr：创建 Pull Request
输入 /pr 后，它会分析分支上的全部提交、生成 PR 标题和描述，再通过 gh pr create 创建。开始前还会检查 PR 是否已经存在。
/review-coderabbit：处理审查意见
输入 /review-coderabbit 后，它会通过 GraphQL 获取 CodeRabbit 评论，根据代码库验证每条建议，实现有效修复；建议不合理时则给出反驳理由，并解决全部讨论串。AI 审查者并不总是正确，因此提示词会确保 Claude 先验证再行动。
/merge-to-main：结束任务
输入 /merge-to-main 后，它会以 Squash 方式合并 PR、删除分支，再拉取 Main。任务完成。
总结
把工作流程移入 .claude/commands/，就是在构建一套系统。
• Bash 命令执行会注入实时上下文
• 模型选择可以平衡速度与推理能力
• 工作流自动处理分支、Lint、提交、CI 调试、PR 和合并
只需定义一次流程，Claude 每次都会执行。
还想进一步扩展 Claude Code？可以通过 MCP（模型上下文协议）连接外部工具，或者把命令打包成可共享插件。
现在，我已经不再思考命名约定、提交消息或 PR 描述，命令会处理一切。
💪 补充：使用 Shell Alias 加快执行
通过
claude -p可以完全跳过交互式提示。把 Alias 添加到.zshrc或.bashrc：alias clint="claude -p '/lint'" alias cpush="claude -p '/push'" alias ccommit="claude -p '/commit'" alias cbranch="claude -p '/branch'"现在，运行
clint就能执行 Lint 命令，不必打开交互会话。-p标志会直接传递提示词，Claude 执行后退出。原本两步的操作缩短成一次按键。
