plugin-features-reference

# 插件特定命令功能参考 本参考涵盖了 Claude Code 插件中捆绑命令的特定功能和模式。 ## 目录 - [插件命令发现](#插件命令发现) - [CLAUDE_PLUGIN_ROOT 环境变量](#claude_plugin_root-环境变量) - [插件命令模式](#插件命令模式) - [与插件组件集成](#与插件组件集成) - [验证模式](#验证模式) ## 插件命令发现 ### 自动发现 Claude Code 会自动发现插件中的命令，路径如下： plugin-name/ ├── commands/ # 自动发现的命令 │ ├── foo.md # /foo (plugin:plugin-name) │ └── bar.md # /bar (plugin:plugin-name) └── plugin.json # 插件清单 **关键点：** - 命令在插件加载时被发现 - 无需手动注册 - 命令会出现在 `/help` 中，并带有 "(plugin:plugin-name)" 标签 - 子目录会创建命名空间 ### 命名空间插件命令 将命令组织在子目录中以进行逻辑分组： plugin-name/ └── commands/ ├── review/ │ ├── security.md # /security (plugin:plugin-name:review) │ └── style.md # /style (plugin:plugin-name:review) └── deploy/ ├── staging.md # /staging (plugin:plugin-name:deploy) └── prod.md # /prod (plugin:plugin-name:deploy) **命名空间行为：** - 子目录名称成为命名空间 - 在 `/help` 中显示为 "(plugin:plugin-name:namespace)" - 有助于组织相关命令 - 当插件拥有 5 个以上命令时使用 ### 命令命名约定 **插件命令名称应：** 1. 具有描述性和动作导向 2. 避免与常用命令名称冲突 3. 多词名称使用连字符 4. 考虑使用插件名称作为前缀以确保唯一性 **示例：** 推荐： - /mylyn-sync (插件特定前缀) - /analyze-performance (描述性动作) - /docker-compose-up (用途明确) 避免： - /test (与常用名称冲突) - /run (太通用) - /do-stuff (无描述性) ## CLAUDE_PLUGIN_ROOT 环境变量 ### 用途 `${CLAUDE_PLUGIN_ROOT}` 是插件命令中可用的特殊环境变量，它解析为插件目录的绝对路径。 **重要性：** - 实现插件内的可移植路径 - 允许引用插件文件和脚本 - 工作