Claude Code 命令开发指南
帮助你为 Claude Code 设计可复用、可交互的斜杠命令。
文档强调使用 allowed-tools 限制权限、避免破坏性 Bash 操作，并说明文件引用和脚本执行；但多个示例使用 Bash(*)、部署或删除操作，缺少一致的显式确认、敏感数据处理、数据流边界和可验证回滚设计。已提供 Anthropic 官方组织归属，但许可证未知，因此扣分。
核心结构、参数、文件引用和错误处理模式说明较完整；但静态材料未提供测试套件或 CI 复现证据，且部分 Bash、条件语法和 AskUserQuestion 集成示例可能依赖未说明的运行时行为。按静态校准限制，未超过 10 分，并因失败路径和语法一致性不足扣分。
触发短语、目标用户和主要场景定义清楚，覆盖普通命令、插件命令、参数、文件引用及交互流程；但非适用边界、实际版本兼容范围、参数缺失行为和中文使用说明不足。核心能力不依赖明确不可达的海外服务，因此未作该项额外扣分。
SKILL.md 提供分层入口、参考文档和示例索引，并包含维护建议；但 README 的版本 0.1.0 与 frontmatter 版本 0.2.0 不一致，状态仍显示增强进行中，许可证、明确维护责任、变更记录和更新路径不完整，且 README 宣称的部分参考内容未在给定材料中出现。
文档覆盖创建 Claude Code slash command 的主要任务，并给出大量可改写模板，核心指导具有直接使用价值；但若干示例依赖未验证的语法、外部脚本、工具权限或插件资源，部分输出仍需人工校验和适配，因此不能按静态证据授予高于 7 分的分数。
材料包含具体代码块、目录约定、字段表和检查清单，提供有限的可审计依据；但没有提交测试、CI、运行日志或第三方复核证据，且未执行任何示例，结论主要依赖文档内部陈述，故仅给低分。
- 不要将示例中的 Bash(*)、部署、删除或回滚模式视为已验证的安全默认值；上线前应确认真实工具权限、用户确认点、参数转义、失败状态和恢复路径。
- 版本信息存在不一致，且部分引用文档或资源未随给定材料提供；应以目标 Claude Code 版本的实际规范和仓库文件为准。
- 未提供中文触发和输出约定，面向中文用户时应补充本地化示例与非适用边界。
它能做什么 & 适用场景
该技能专门指导 Claude Code 斜杠命令的设计与组织。内容涵盖 Markdown 命令文件、YAML frontmatter、参数替换、文件引用和内联 Bash 执行。它还介绍插件命令、命名空间、插件资源以及与 agents、skills 和 hooks 的协作方式。适合需要把重复编码流程封装成团队或个人命令的 Claude Code 用户。
指导用户创建 .md 格式的斜杠命令，配置 description、allowed-tools、model、argument-hint 和 disable-model-invocation 等字段；使用 $ARGUMENTS、$1 等变量处理参数；使用 @ 引用文件、使用内联 Bash 收集 Git 或环境上下文；规划项目、个人和插件命令目录；并为参数、文件、插件资源和命令执行提供校验及错误处理模式。
- 团队希望在项目的 `.claude/commands/` 中共享代码审查、测试或部署流程时。
- 个人希望在所有项目中复用固定工作流，并将命令放入 `~/.claude/commands/` 时。
- 插件开发者需要为插件添加带命名空间的命令、脚本、模板或配置引用时。
- 开发者需要让命令接收 issue、PR、环境或文件路径等动态参数时。
- 用户希望在执行命令前读取指定文件或通过 Bash 获取 Git 状态时。
优缺点一览
- 覆盖从基础 Markdown 命令到插件级工作流的完整设计要点。
- 提供参数、文件引用、Bash 执行、校验和错误处理示例。
- 明确区分项目、个人和插件命令的作用域。
- 包含与 agents、skills、hooks 及插件资源协作的模式。
- 高度依赖 Claude Code 的斜杠命令、`$ARGUMENTS`、`@` 文件引用和内联 `!` 命令机制。
- 源材料没有提供独立安装方法，也没有说明版本兼容范围或测试套件。
- 部分示例涉及 Git、npm、gh、Node.js 或插件脚本，但并非所有环境都具备这些依赖。
- 技能本身是开发指导，不是可独立运行的命令执行器。
如何安装
该技能位于仓库 plugins/plugin-dev/skills/command-development/SKILL.md，源材料没有说明单独安装此技能的步骤。README 说明 Claude Code 可通过 curl -fsSL https://claude.ai/install.sh | bash（MacOS/Linux）或 irm https://claude.ai/install.ps1 | iex（Windows）安装，随后进入项目目录运行 claude。
如何使用
在 Claude Code 中提出与命令开发相关的请求，例如“create a slash command”或“define command arguments”。需要创建命令时，使用 .claude/commands/、~/.claude/commands/ 或插件的 commands/ 目录，并按指南编写 Markdown、frontmatter、参数变量、文件引用和 Bash 片段。