SuperAPI AI 工具集

plugin-structure

通用与其它

查看项目

更新于 10-16 04:32

技能介绍

用途:帮助开发者创建、搭建并理解 Claude Code 插件的标准目录结构与组件组织方式,使插件可维护且能被自动发现。

主要能力:说明约定式目录布局与自动发现机制;讲解 .claude-plugin/plugin.json 清单配置(name 必填,version、description、author、keywords 等为推荐元数据,版本遵循语义化版本);介绍组件类型——commands(.md 斜杠命令)、agents(.md 子智能体)、skills(含 SKILL.md 的子目录,可带 scripts/references/examples 等资源,并可用 allowed-tools 限制工具)、hooks(hooks.json 事件处理,事件含 PreToolUse、PostToolUse、SessionStart 等)、.mcp.json 的 MCP 服务器、plugin.json 内联的 lspServers 与 outputStyles。

使用方式:组件目录须位于插件根级而非 .claude-plugin/ 内;自定义路径须以 ./ 开头且相对插件根,仅补充而非替换默认目录;所有插件内路径引用使用 ${CLAUDE_PLUGIN_ROOT},避免硬编码绝对路径。开发时可用 claude --plugin-dir /path/to/plugin 免安装测试,或重启 Claude Code 重载;校验可用 claude plugin validate、claude --debug、claude --verbose 与 /plugins。

适用场景:构建最小插件、全功能插件或仅含技能的插件;需要命令、智能体、技能、钩子、MCP/LSP 集成或自定义输出样式时。

限制:插件被沙箱限制在其目录内,外部路径不可靠且不被缓存监控;无头/CI 模式与 GitHub Actions 下部分功能不可用;缓存内容在会话重启、重装或更新后刷新。具体细节可参考资料中提到的 references 文档。