斜杠命令构建器
做一个可复用的命令,参数已经接好并检查过。
命令提示词常常写着内部的评审标准。一切都在浏览器里生成,不会上传。
把命令打包成插件
关于 斜杠命令构建器
斜杠命令是一个 Markdown 文件,正文直接变成提示词。它是"别再重复敲同一个请求"最简单的办法——一次评审、一次发版前检查、一份团队期待格式的摘要——也是整套配置里最不挑剔的部分。唯一容易出岔子的地方是参数。命令名之后敲的一切会作为一个占位符送达,单个词则作为编号占位符送达;而一个从不引用它们的正文,会一边忽略用户传入的内容,一边继续宣称自己接受参数。这个构建器写出文件,把占位符做成按钮,并从两个方向指出这种不一致。
功能特性
- 占位符靠按钮插入,不必记住
- 宣称有参数但正文从不使用时发出警告
- 正文使用了参数却没有任何提示告诉用户传什么时发出警告
- 可选的工具列表与模型指定
- 名称按文件名规则检查——因为它就是文件名
- 项目范围或个人范围,并给出对应路径
- 预览这个命令将怎么被敲出来
- 下载为可直接使用的 .md 文件
如何使用 斜杠命令构建器
- 给命令命名——它同时是 /名称 和文件名
- 在输入该出现的位置插入 $ARGUMENTS 或 $1,写好提示词
- 加一条参数提示,让用户知道要传什么
- 选好范围,下载文件
示例
输入
argument-hint: <pr-number>
输出
Review pull request #$1.
提示与占位符必须对上,否则其中一个在说谎。
常见错误与故障排除
- 命令忽略了我在后面敲的内容。 — 正文必须用到输入。$ARGUMENTS 是敲下的全部内容;$1、$2、$3 是单个的词。
- 命令没出现在列表里。 — 文件名就是命令名,所以要小写加连字符,而且文件必须放在所选范围的 commands 目录下。
- 列表里没有描述。 — 它来自 frontmatter 的 description 字段。没有它,命令就以无标签的样子出现。
- $1 和 $ARGUMENTS 看起来重叠了。 — 确实重叠:$ARGUMENTS 包含全部,$1 是其中第一个词。除非你有意兼用,否则只取其一。
常见问题
- $ARGUMENTS 和 $1 有什么区别?
- $ARGUMENTS 是命令名之后敲下的整个字符串。$1、$2、$3 是按空格分开的词。命令接收固定几项输入时用编号的,接收自由文本时用 $ARGUMENTS。
- 需要工具白名单吗?
- 不需要,多数命令也没有。值得设置的情形是:某个命令应当不必每次询问就执行某件具体的事,或者你希望它做不到会话本来能做的某件事。
- 命令文件放在哪里?
- 项目命令放在仓库里,团队都能用;个人命令跨项目跟着你。确切路径会显示出来,并随名称更新。
- 命令能调用工具或执行 shell 吗?
- 正文就是提示词,所以能请求会话本来就能做的任何事。工具列表只是放宽或收紧"不询问即执行"的范围,并不会授予新权限。
- 什么时候该做成命令而不是技能?
- 命令靠你敲出来主动调用。技能会在任务看起来相关时自动被匹配。想自己决定时机就写命令;想让它自己发生就写技能。
相关工具
- 技能构建器 — 编写 SKILL.md,边输入边检查 frontmatter。
- 子代理构建器 — 生成子代理定义文件,含工具与模型设置。
- 钩子构建器 — 构建 settings.json 钩子,找出永远不会触发的匹配式。
- 插件清单构建器 — 生成 plugin.json,并查看它所预设的目录结构。
- 项目说明构建器 — 写一份对得起每次请求开销的 CLAUDE.md。
- 提示模板填充 — 把一条提示展开到整张表格,并看清缺了哪些值。
更多AI 与智能体工具
查看全部AI 与智能体工具 · 全部工具