Claude Code 命令开发指南
帮助你设计、配置并组织可复用的 Claude Code 斜杠命令。
文档强调使用 allowed-tools 限制权限、输入校验、失败处理和用户确认，并提示避免破坏性操作；但示例多次使用 Bash(*)、部署脚本、rm、凭据和外部服务，未系统说明数据流、敏感信息处理、回滚边界或默认确认机制，因此扣分。未见恶意代码、凭据窃取或隐蔽外传等红线风险。
核心概念、参数、文件引用、校验和故障处理都有覆盖，且提供了较多可复用示例；但文档包含伪代码式条件语法、Shell 插值与命令执行语义可能混用，部分示例依赖未在本次材料中提供的脚本或参考文件，也没有可验证的测试结果，因此按静态上限保守扣分。
frontmatter 明确列出触发短语，覆盖创建命令、参数、引用、Bash 和交互场景；也区分项目、个人和插件范围。非适用边界、具体运行时版本和中文使用说明不足，部分能力依赖 Bash、npm、gh、kubectl 或远程服务，在不同环境尤其是中国大陆网络下的可达性未说明，因此扣分。
信息架构较清晰，SKILL.md、README、references 和 examples 形成渐进式结构，包含维护说明、版本字段、故障排查和更新建议；但 frontmatter 为 0.2.0，README 仍称 v0.1.0，README 的文件清单与本次材料不完全对应，许可证和维护责任主要来自外部元数据而非技能文档本身，且若干“进行中”项目缺少明确更新路径，因此扣分。
该技能覆盖命令文件结构、常见 frontmatter、动态参数、文件引用、插件根目录、校验和工作流模式，示例可直接作为编写模板，核心任务大体可完成；但示例未经过执行验证，部分语法和工具行为可能需要人工校正，且复杂部署案例仍依赖外部脚本、权限和环境，所以不满分。
材料包含结构化的一手文档、示例、检查清单和维护声明，能够审计主要主张；但没有提交的测试套件、CI 结果、版本化行为对照或第三方执行证据，且部分被引用文件未提供，故仅给静态审查可支持的有限分数。
- 不要把示例中的 Bash(*)、部署、删除或外部服务调用视为安全默认值；实际命令应缩小工具权限并在有副作用前明确请求用户确认。
- 执行前应核对 Claude Code 当前版本中的 frontmatter、$ARGUMENTS、@、!` 和 AskUserQuestion 语法；本材料未提供可复现测试证据。
- 应修正 0.2.0 与 v0.1.0 的版本冲突，并补充依赖、非适用范围、敏感数据处理、回滚和中国大陆网络可达性说明。
它能做什么 & 适用场景
该技能面向需要创建或维护 Claude Code 斜杠命令的开发者。它讲解 Markdown 命令文件、YAML frontmatter、动态参数、文件引用、内联 Bash 执行和命令命名空间。内容还覆盖插件命令、CLAUDE_PLUGIN_ROOT，以及命令与代理、技能和钩子的协作方式。由于它依赖 Claude Code 的斜杠命令机制，适合 Claude Code 插件开发，不是通用脚本开发指南。
说明如何在 .claude/commands/、~/.claude/commands/ 或插件 commands/ 目录中组织 Markdown 命令；配置 description、allowed-tools、model、argument-hint 和 disable-model-invocation 等 frontmatter；使用 $ARGUMENTS、$1 等动态参数；通过 @ 引用文件、通过 !... 执行 Bash；并为参数、文件、插件资源和错误进行验证。
- 需要为团队项目创建 /review、/deploy 等共享命令的 Claude Code 开发者。
- 需要为个人跨项目工作流维护用户级斜杠命令的开发者。
- 正在开发插件，需要组织插件命令、避免命名冲突并引用插件资源的作者。
- 需要让命令接收参数、读取文件或运行 git、npm、gh 等命令的工程师。
- 需要组合命令、代理、技能、脚本和模板来构建多阶段工作流的插件作者。
优缺点一览
- 覆盖从基础 Markdown 命令到插件命令组织的完整主题。
- 提供参数、文件引用、Bash、验证和错误处理示例。
- 明确区分项目命令、个人命令和插件命令。
- 说明 CLAUDE_PLUGIN_ROOT 及命令与其他插件组件的集成方式。
- 内容明确针对 Claude Code 斜杠命令机制，移植到其他客户端需要调整。
- 源材料未提供测试套件、兼容平台列表或实际运行验证结果。
- Bash 示例可能涉及 git、npm、gh、node 等外部命令，但未给出统一依赖清单。
- 部分详细规范指向未提供的 references 文件，单凭当前材料无法核验其内容。
如何安装
该技能属于 anthropics/claude-plugins-official 仓库中的 plugin-dev 插件。根据仓库 README，在 Claude Code 中运行：/plugin install plugin-dev@claude-plugins-official。源材料未说明其他客户端的安装步骤。
如何使用
安装后，用自然语言提出触发条件，例如“create a slash command”或“define command arguments”。也可以询问“use command frontmatter”“create command with file references”或“interactive command”。技能会围绕命令结构、参数、工具权限、文件引用和 Bash 执行给出指导。