SuperAPI AI 工具集

command-development

编程与开发

查看项目

更新于 10-16 08:40

技能介绍

用途:该技能指导如何为 Claude Code 创建斜杠命令。命令是定义为 Markdown 文件的可复用提示词,可带可选的 YAML frontmatter。关键点:命令是写给 Claude 的指令,而不是发给用户的消息。

文件位置:.claude/commands/ 为项目级(通过 git 共享);~/.claude/commands/ 为个人级(所有项目);plugin/commands/ 用于插件分发。

Frontmatter 字段:description 为 /help 中显示的帮助文本;allowed-tools 限制工具访问(如 Bash(git:*));model 指定模型(haiku、sonnet、opus);argument-hint 记录预期参数;disable-model-invocation 阻止程序化调用。

动态特性:参数方面,$ARGUMENTS 表示全部参数作为单个字符串,$1、$2、$3 为位置参数;文件引用方面,@src/main.ts 包含文件内容,@$1 基于参数引用;内联 Bash 执行方面,可用 ! 反引号执行命令,如 !git branch --show-current 获取当前分支、`!`git log --oneline -5 获取最近提交。

命名与组织:采用动词-名词格式,如 review-pr.md、generate-tests.md、fix-issue.md。命令少于 15 个时可平铺;15 个以上使用命名空间目录,如 git/commit.md 变为 /git-commit,testing/run-tests.md 变为 /testing-run-tests。

最佳实践:单一职责,每个命令只做一件事;始终用 argument-hint 记录参数;处理前校验输入;合理使用 allowed-tools 限制工具;使用清晰的动词-名词命名。

限制:资料未提供更多关于错误处理、版本兼容性或具体平台差异的说明。