跳到主要内容

自定义斜杠命令

进阶

一个自定义斜杠命令把你反复输入的提示打包成一个 /word。定义一次，永久复用（还能分享给你的团队）。

它们如何工作​

一个命令就是一个 Markdown 文件。把它放进你的命令目录，它的文件名就成了命令：

  • .claude/commands/changelog.md → /changelog（项目命令，可共享）
  • ~/.claude/commands/changelog.md → /changelog（个人，所有项目通用）

文件的正文就是你调用时 Claude 运行的提示。

一个最小示例​

---
description: Draft a Conventional Commit message from the staged diff
---

Look at the staged changes with `git diff --cached` and write a single
Conventional Commit message (feat/fix/docs/refactor/chore). Output only the
message, no preamble.

现在 /changelog……呃，/commit（文件叫什么就叫什么名字）每次都会做这件事。

实用的构建块​

  • $ARGUMENTS——注入用户在命令之后输入的内容。/review src/auth.ts → 该路径会落入你的提示。
  • 运行 bash 并嵌入输出——命令可以包含 shell 输出（例如当前 diff），让 Claude 基于实时状态来行动。
  • 引用文件——指向某些文件以包含它们的内容。
  • 前置元数据——description（显示在菜单中）以及其他选项。

参数、bash 和文件引用的确切语法见官方文档。

值得"偷"来的命令​

我们的斜杠命令库里有一套起始命令：提交信息、PR 描述、代码审查、变更日志、脚手架式生成组件。

命令 vs 技能 vs 子智能体​

  • 斜杠命令——由你按需触发一个已知的工作流。
  • 技能——Claude 在相关时自动加载专长。
  • 子智能体——把一大块工作委派给一个隔离的智能体。

下一步​