SuperAPI AI 工具集

developing-commands

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:帮助开发者编写 Claude Code 的斜杠命令。命令是 Markdown 文件,用户调用 /command-name 时其内容即成为 Claude 的指令,因此应写成对 Claude 的指令而非对用户的说明。

主要能力:支持项目命令(.claude/commands/)、个人命令(~/.claude/commands/)和插件命令(plugin-name/commands/)三种位置。YAML frontmatter 可用字段包括 description、allowed-tools、model、argument-hint、disable-model-invocation。支持 $ARGUMENTS 捕获全部参数,$1/$2 等定位参数,@ 语法引用文件内容,以及内联 bash 执行以获取动态上下文(如 git diff --name-only)。插件命令可使用 ${CLAUDE_PLUGIN_ROOT} 引用插件内脚本、配置和模板。

用法要点:命令可平铺或按子目录做命名空间分组;单命令单职责,用动词-名词命名;用 allowed-tools 限制工具范围(如 Bash(git:*));始终提供 argument-hint;为复杂命令添加注释与示例。

限制与注意:命令为 Claude 而非用户编写;需注意参数校验、文件存在性检查与 bash 命令安全;命令不显示时检查目录、扩展名与格式;参数不生效时核对 $1 语法及 argument-hint;bash 失败时确认 allowed-tools 与权限。具体 bash 执行语法与插件功能细节需参考资料提及的 references/plugin-features-reference.md。