Agent工坊

【Agent工坊】Claude Code 自定义斜杠命令:3个模板让你的AI编程效率翻倍

如果你每天在终端里输入相同的 prompt 让 Claude Code 做代码审查、重构或部署检查,这篇文章能让你一键完成。实测配置5分钟后,原来每次要打80字的 prompt 缩减为一个 /review 命令——而且结果更一致、质量更高。

你正在浪费的「重复打字」时间

先看一个场景:你刚写完一个功能模块,想让 Claude Code 帮你做代码审查。你会输入类似这样的 prompt:

请审查我刚修改的代码,重点关注:
1. 错误处理是否完善
2. 是否有 SQL 注入或 XSS 风险
3. 函数命名是否符合项目规范
4. 是否有明显的性能问题
请按严重程度排序,给出具体的修改建议和代码示例

这段 prompt 大概 80 个中文字符+英文,每次都要手动打一遍。一天审查 5 次,一周就是 25 次,一年上千次。

更糟的是,手动输入不一致——有时候你忘了提"SQL 注入检查",有时候忘了加"给出代码示例",审查质量参差不齐。这就是「隐性质量成本」:同样的任务,因为 prompt 不一致,AI 给出的结果时好时坏。

Claude Code 的自定义斜杠命令(Custom Slash Commands)专门解决这个痛点。 你只需把最佳 prompt 写成文件,以后输入 /review 就能自动调用,保证每次都用同一套标准。

自定义斜杠命令的工作原理

Claude Code 会扫描项目目录下的 .claude/commands/ 文件夹,每个 .md 文件自动注册为一个斜杠命令:

项目根目录/
├── .claude/
   ├── commands/
      ├── review.md         注册为 /review
      ├── refactor.md       注册为 /refactor
      └── deploy-check.md   注册为 /deploy-check
   └── settings.json
├── src/
└── package.json

文件名(不含 .md)就是命令名。 文件内容就是发送给 Claude 的完整 prompt——支持变量替换、文件引用等高级功能。

模板一:/review —— 代码审查命令

这是最常用的命令。创建一个标准化的代码审查 prompt:

文件:.claude/commands/review.md

请对当前修改的代码进行全面的代码审查(Code Review)。

## 审查维度(按优先级排序)

### 1. 🔴 安全问题(最高优先级)
- SQL 注入、XSS、CSRF 漏洞
- 敏感信息泄露(API Key、密码硬编码)
- 权限校验缺失
- 依赖库的已知漏洞

### 2. 🟡 错误处理
- 异常捕获是否完整
- 错误信息是否对用户友好
- 是否有静默吞掉异常的情况
- 边界条件处理(空值、超长输入、并发)

### 3. 🟢 代码质量
- 函数/变量命名是否清晰(看名字就知道做什么)
- 单一职责原则:一个函数是否做了太多事
- 是否有重复代码可以提取
- 注释是否准确且必要

### 4. 🔵 性能
- 是否有 N+1 查询
- 循环内是否有不必要的计算
- 数据结构选择是否合理

## 输出格式
请按严重程度排序输出,每条问题包含:
- 严重等级(🔴严重 🟡中等 🟢建议)
- 问题描述(1句话)
- 具体代码位置和行号
- 修改建议(给出修改后的代码示例)
- 影响评估

最后给出总体评分(1-10分)和一键修复建议。

使用方式:在 Claude Code 对话中直接输入 /review,Claude 会自动读取文件内容作为 prompt,对当前修改进行审查。

模板二:/refactor —— 重构命令

当你觉得一段代码「能跑但很丑」,用这个命令一键重构:

文件:.claude/commands/refactor.md

请对以下代码进行重构,目标:

## 重构原则
1. **可读性优先**:6个月后回来看一眼就能理解逻辑
2. **减少嵌套层级**:超过3层 if/for 嵌套必须扁平化
3. **提取魔法数字**:所有硬编码数字提取为命名常量
4. **函数拆分**:单个函数超过30行考虑拆分子函数
5. **不改变外部行为**:重构后输入输出保持一致

## 输出要求
- 先给出重构后的完整代码
- 再列出主要改动点(每个改动一句话说明理由)
- 如果有权衡取舍,说明为什么选择了这个方案
- 标注任何你可能引入的潜在风险

## 上下文
$ARGUMENTS

这里的 $ARGUMENTS 是特殊变量——你在 /refactor 把那个用户验证逻辑拆开 中,$ARGUMENTS 就会被替换为「把那个用户验证逻辑拆开」。

模板三:/deploy-check —— 部署前检查

每次部署前都紧张?用这个命令做最后的检查:

文件:.claude/commands/deploy-check.md

请对即将部署的变更进行部署前安全检查(Pre-Deployment Checklist)。

## 检查清单

### 数据库变更
- 是否有新的 migration 文件
- migration 是否有对应的 rollback
- 大表(>100万行)的 ALTER TABLE 是否有锁表风险
- 索引变更是否合理

### API 兼容性
- 是否有破坏性 API 变更(字段删除/类型变更)
- 新增字段是否有默认值
- 旧版本客户端是否兼容

### 配置与环境
- 是否有新的环境变量需要添加
- 默认值是否合理(dev/staging/prod)
- 敏感配置是否正确使用 Secret Manager

### 错误与监控
- 新增的错误是否能被现有监控捕获
- 是否有合适的日志级别
- 是否有可能导致告警风暴的新错误

### 回滚计划
- 如果部署后发现问题,回滚步骤是什么
- 数据库 migration 回滚是否可逆
- 是否有数据一致性风险

## 输出格式
每项检查结果:
✅ 通过 / ⚠️ 需人工确认 / ❌ 必须修复

最后给出:Go / No-Go 建议和理由。

高级技巧:带参数的动态命令

除了 $ARGUMENTS,Claude Code 还支持在命令文件中引用当前上下文:

变量/指令 说明 示例
$ARGUMENTS 用户在命令后输入的所有文本 /refactor 拆分那个300行的函数$ARGUMENTS = "拆分那个300行的函数"
$SELECTED_TEXT 用户在 IDE 中选中的代码 选中一段函数后 /explain 会分析选中内容
请检查当前文件 Claude 自动读取当前打开的文件 无需变量,天然就有的上下文

实战组合技:在 VS Code 中选中一段代码,然后输入 /refactor 降低圈复杂度,Claude 会同时拿到选中的代码和你对重构方向的要求。

项目级 vs 全局级命令

Claude Code 支持两个层级的命令:

项目级(仅当前项目可用):
  .claude/commands/*.md

全局级(所有项目可用):
  ~/.claude/commands/*.md

建议
- 把与具体项目强相关的命令放项目级(如 deploy-check.md、特定业务逻辑的审查规则)
- 把通用命令放全局级(如 review.mdrefactor.md),跨项目复用

管理技巧:可以用 Git 管理 .claude/commands/ 目录,团队成员共享同一套代码审查标准:

# 团队成员克隆项目后自动获得命令
git clone your-project
cd your-project
claude  # /review、/refactor 等命令自动可用

实测效果:从 80 字到 4 个字符

这是我一周的实际统计数据(日均 6 次 Claude Code 对话):

指标 手动输入 prompt 自定义命令
每次耗时 30-45 秒(打字+思考检查项) 2 秒(输入 /review
Prompt 一致性 时好时坏,频繁遗漏检查项 100% 一致,14 个检查项全覆盖
审查质量评分 4-7 分(波动大) 稳定 7-8 分
日均使用次数 3-4 次(懒得打字) 6-8 次(一键调用,多审无害)

最大的意外收获:因为太方便了,我现在写完一个函数就 /review 一次,而不是攒到 PR 时才审查。这让问题在 5 分钟内就被发现,而不是等到 Code Review 环节才发现——修复成本从 30 分钟降到 2 分钟。

常见问题

Q: 命令文件能用中文吗?
A: 完全可以。文件名和内容都支持中文。/代码审查.md/review.md 都可以。建议文件名用英文避免编码问题,内容中英混合没有问题。

Q: 命令里能调用 MCP 工具吗?
A: 可以。如果 Claude Code 配置了 MCP 工具(如 Filesystem、PostgreSQL),命令 prompt 中可以直接提到让 Claude 使用这些工具。比如 /deploy-check 中可以写「检查数据库连接池配置 → 使用 PostgreSQL MCP 工具查询 SHOW max_connections」。

Q: 命令文件更新后需要重启 Claude 吗?
A: 不需要。Claude Code 在每次输入 / 时都会重新扫描 .claude/commands/ 目录,修改即时生效。但正在执行的命令不会被打断——如果你改了命令文件,下次调用 /review 时才会使用新版本。

Q: 如何分享命令给团队?
A: 如上所述,把 .claude/commands/ 加入 Git 版本控制。建议搭配 .claude/settings.json 一起管理,统一团队的 Claude Code 配置。

Q: 最多可以创建多少个命令?
A: 没有硬性限制。但建议控制在 10 个以内——超过 10 个说明你可能需要合并一些命令,或用 $ARGUMENTS 让一个命令覆盖多种场景。太多了反而记不住。

行动建议

  1. 今天:创建 .claude/commands/ 目录,把上面的 3 个模板复制进去
  2. 明天:用 /review 审查你今天写的所有新代码,对比以前的手动 prompt 质量
  3. 本周:分析你的日常 Claude Code 使用场景,把最常用的 2-3 个 prompt 封装为命令
  4. 团队推广:把 .claude/commands/ 加入 Git,让全团队用同一套标准

最重要的心法:把「人脑记忆检查项」这件事外包给文件。你的大脑应该用来思考创造性的问题,而不是每次审查代码时都要回忆「我要检查哪 14 个维度来着?」


AI创业 #ClaudeCode #Agent工坊 #一人公司 #开发效率