SuperAPI AI 工具集

Plugin Structure

通用与其它

查看项目

更新于 10-15 18:31

技能介绍

用途:本技能帮助创建、搭建和理解 Claude Code 插件的标准化目录结构。Claude Code 插件采用约定的目录布局,并自动发现组件,便于构建组织良好、易维护的插件。

主要能力:

  • 清单配置:插件清单必须位于 .claude-plugin/plugin.json,name 为必填字段,采用 kebab-case 且全局唯一;可配置 version(语义化版本)、description、author、homepage、repository、license、keywords。
  • 组件目录:commands(.md 斜杠命令)、agents(.md 子智能体)、skills(每个技能一个子目录,含必需的 SKILL.md)、hooks(hooks.json)、.mcp.json(MCP 服务器定义)、scripts(辅助脚本)。所有组件目录必须在插件根级,不能嵌套在 .claude-plugin/ 内。
  • 自动发现:扫描 commands/ 与 agents/ 下的 .md 文件、skills/ 下含 SKILL.md 的子目录,并从 hooks/hooks.json 或清单加载钩子、从 .mcp.json 或清单加载 MCP 服务器。
  • 自定义路径:可在清单中指定 commands、agents、hooks、mcpServers 路径,须相对插件根并以 ./ 开头,且为补充而非替换默认目录。
  • 可移植路径:所有插件内路径引用使用 ${CLAUDE_PLUGIN_ROOT},避免硬编码绝对路径、工作目录相对路径或 ~ 快捷方式。

必要用法:创建插件时先建立 .claude-plugin/plugin.json,再按需添加组件目录;命令与智能体为带 YAML frontmatter 的 Markdown 文件,技能为含 SKILL.md 的子目录。钩子支持事件 PreToolUse、PostToolUse、Stop、SubagentStop、SessionStart、SessionEnd、UserPromptSubmit、PreCompact、Notification,命令中可引用 bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/validate.sh。命名统一使用 kebab-case。

适用场景与限制:适用于为 Claude Code 搭建插件、组织组件或排查组件未加载、路径解析错误、自动发现失效与插件冲突等问题。插件安装位置随安装方式与系统而异,需依赖可移植路径;具体收费、价格与平台支持信息暂未提供。