SuperAPI AI 工具集

plugin-structure

通用与其它

查看项目

更新于 10-15 16:45

技能介绍

用途:本技能在用户询问“创建插件”“搭建插件脚手架”“理解插件结构”“组织插件组件”“设置插件”等场景下启用,用于指导按 Claude Code 标准目录结构构建可维护、可移植的插件。

主要能力:讲解约定式目录布局与自动发现机制;说明 .claude-plugin/plugin.json 清单驱动配置;介绍基于组件的组织方式(commands、agents、skills、hooks);说明使用 ${CLAUDE_PLUGIN_ROOT} 的可移植路径引用,以及显式加载与自动发现组件的区别。

结构要点:清单 plugin.json 必须位于 .claude-plugin/ 目录;commands、agents、skills、hooks 等组件目录必须放在插件根级,不能嵌套进 .claude-plugin/;只为实际使用的组件创建目录;目录与文件名使用 kebab-case。清单 required 字段为 name,另可含 version、description、author、homepage、repository、license、keywords 等元数据;commands、agents、hooks、mcpServers 等自定义路径须相对根目录且以 ./ 开头,支持数组,且为补充而非替换默认目录。

组件组织:commands/ 放带 YAML frontmatter 的 .md,作为斜杠命令;agents/ 放子代理定义 .md;skills/ 下每个技能独立子目录并包含 SKILL.md,可附带 scripts、references、examples 等;hooks/hooks.json 配置事件处理,支持 PreToolUse、PostToolUse、Stop、SubagentStop、SessionStart、SessionEnd、UserPromptSubmit、PreCompact、Notification 等事件;.mcp.json 定义 MCP 服务器并在启用时自动启动。

用法与限制:路径统一使用 ${CLAUDE_PLUGIN_ROOT},禁止硬编码绝对路径、相对工作目录路径或 ~ 家目录路径;安装或启用时注册组件,改动通常下次会话生效。文件命名遵循 kebab-case,文档建议包含 README。付费、价格、平台支持范围等资料暂未提供。