使用 Claude Code 的 Slash Command 编排工作流，让 AI 半夜持续为你打工
发布于 2025年8月26日
想象一下这样的场景：你刚写完一段关键代码，需要进行全面审查：代码质量、安全漏洞、性能瓶颈、测试覆盖等等，每一项都需要专业的人或者 Agent 帮你完成。Claude Code 可以为每一个场景编写一个 Agent，但是有没有一种方式可以把他们串起来呢？
这就是今天要分享的核心技巧——自定义斜杠命令（Slash Commands）。
回顾 Agent 的调用
在上一篇 使用 Claude Code 的 Agent 帮助你更快编写更好的代码 文章中介绍了使用 Claude Code 自定义 Agent 以及使用别人编写好的 Agent。
他有两种调用 Agent 的方式：
- 自动委派：当你的提示词包含了一些 Agent 的描述，或者执行到了某些步骤，就会根据情况自动去调用
- 显式调用：你可以直接说
使用 code-reviewer subagent 检查的我最近的代码
对于复杂的工作流程，你可能会想让 Claude Code 调用不同的 Agent 处理不同的事情。你可以说 首先使用 code-reviewer subagent 检查的我最近的代码，针对需要改进的内容，使用 optimizer subagent 修复代码。
这里的我们让 Claude Code 逐个调用了 code-reviewer, optimizer 两个 agent 。
对于常见的工作流程，每次都要重复写这么长的提示词，太麻烦了，我们可以通过自定义斜杠命令，来编排工作流。复用这段提示。
什么是斜杠命令（Slash Commands）
你可以输入 / 就可以看到一堆的命令列表。
这个你肯定比较熟悉了，系统内置了很多 Slash Commands 。
Claude Code 还可以自定义斜杠命令，这样我们就可以快速启动一个定制化的工作流了。
自定义的斜杠命令
其实每一个斜杠命令都是一个 markdown 文件，存放在全局（~/.claude/commands/）或者项目级别（.claude/commands/）中。
语法
/<command-name> [arguments]
<command-name> 是就是 markdown 的文件名。以文件名命名 Slash Commands。
[arguments] 是传递给斜杠命令的可选参数，不同于严谨的命令行，他可以是一句提示词。
在自定义的斜杠命令中，使用 $ARGUMENTS 来接收参数（实际上是内容的一个占位符）。
文件内容
整个 markdown 文件的格式如下
---
allowed-tools: Bash(npm build:*), ...
argument-hint: 检查XXX
description: XXX
model: claude-4-sonnet
---
## Context
- 当前的 git status: !`git status`
- ...
## Task
1. 根据 $ARGUMENTS XXX
2. 对比 @src/xxx.ts XXX
3. 深度思考XXX
我们一步一步来拆分：
元数据
在 --- 包裹的内容中是这个斜杠命令一些参数。
allowed-tools: 该斜杠命令可以使用哪些工具
argument-hint: 所需的参数，
description: 是斜杠命令的一句话描述
model: 可以自定义模型。默认使用当前对话的模型。
执行命令
你可以在文档中标注一些命令，然后就可以使用这些命令的输出结果作为上下文。他的语法就是
!`command`
执行斜杠命令时，会执行这些命令。
参数
$ARGUMENTS 就是你使用斜杠命令时候的参数，来作为上下文
文件引用
你可以使用 @path 来引用指定文件，这个一般都用于项目中的斜杠命令。
思考模式
当提示词包含了 深度思考XXX Think deeply about XXX 这样的提示词，Claude Code 会进行多步骤的推理。
自定义一个全面代码审查的 Slash Commands
预期
我们预期的使用方式为 /full-review 检查身份验证模块。然后 Claude Code 就会全面的检查这部分代码。
示例内容
首选在 ~/.claude/commands/ 目录中创建一个文件 full-review.md 。
内容大致可以这么写
---
description: 全面的代码审查
---
执行多个专业的 subagent 进行全面审查，并明确调用任务工具：
[扩展思考：该工作流程通过协调多个专业审查代理，实施彻底的多角度审查。每个 agent 负责检查不同方面，最终将结果整合为统一的行动计划。]
使用任务工具与专业的 subagent 并行执行审查：
## 1. 代码质量检查
- 使用 subagent_type="code-reviewer"
- 提示词: "对以下代码进行质量与可维护性审查：$ARGUMENTS。检查代码异味、可读性、文档完整性及最佳实践遵循情况"。
- 重点：代码整洁原则、SOLID 原则、DRY 原则、命名规范
## 2. 安全审查
- 使用 subagent_type="security-auditor"
- 提示词: "对以下内容进行安全审计：$ARGUMENTS。检查漏洞、OWASP合规性、认证问题及数据保护措施"。
- 重点: 注入风险、身份验证、授权机制、数据加密
## 3. 架构评审
- 使用 subagent_type="architect-reviewer"
- 提示词: "审查以下架构设计与模式：$ARGUMENTS。评估其可扩展性、可维护性及对架构原则的遵循程度。"。
- 重点: 服务边界、耦合性、内聚性、设计模式
## 4. 性能分析
- 使用 subagent_type="performance-engineer"
- 提示词: "分析以下内容的性能特征：$ARGUMENTS。识别瓶颈、资源使用情况以及优化机会。"。
- 重点: 响应时间，内存使用情况，数据库查询，缓存
## 5. 测试覆盖率评估
- 使用 subagent_type="test-automator"
- 提示词: "评估以下内容的测试覆盖范围与质量：$ARGUMENTS。检查单元测试、集成测试，并识别测试覆盖中的空白。"。
- 重点: 覆盖率指标，测试质量，边界情况，测试可维护性
## 合并报告结构
将所有反馈整理成一份统一报告。:
- **关键问题** (必须修复): 安全漏洞、功能故障、架构缺陷
- **推荐** (应该修复): 性能瓶颈、代码质量问题、测试缺失
- **建议** (建议修复): 重构机会，文档改进
- **正面反馈** (哪方面做得好): 良好实践以维护和复制
目标: $ARGUMENTS
就这样，一份对代码进行全面分析的自定义斜杠命令就完成了，他是一套不错的工作流，集合了 5 个 agent。共同对内容进行审查。
更多的 Slash Commands
同理，你也可以创建多种多样的 Slash Commands 来满足你的需求。
https://github.com/wshobson/commands 这个仓库预设了一套适用于 Claude Code 的 Slash Commands 集合。有丰富的针对复杂任务的多 agent 编排。
结尾
这种工作流可以做得更复杂、更智能。你甚至可以在睡觉前启动一个完整的项目审查流程，第二天醒来就能看到详细的分析报告。充分利用 Claude Code 的按时间段限流，让 AI 持续为你打工。
如果你觉得这篇文章对你有帮助，欢迎点赞、分享，你的支持是我持续创作的最大动力！