是什么
Claude Code 插件系统的完整技术规范，涵盖各组件的 Schema、CLI 命令和开发工具。Plugin 是包含 Skills、Agents、Hooks、MCP Servers、LSP Servers 和 Monitors 的自包含目录。
核心机制
组件类型：
- Skills：
skills/目录，每个 Skill 是含SKILL.md的子目录 - Agents：
agents/目录，Markdown 文件定义专用子 Agent - Hooks：
hooks/目录，生命周期钩子配置 - MCP Servers：
mcp-servers/目录，MCP Server 配置 - LSP Servers：
lsp-servers/目录，语言服务器配置（代码智能） - Monitors：
monitors/目录，后台监控脚本
Agent frontmatter 支持字段：name、description、model、effort、maxTurns、tools、disallowedTools、skills、memory、background、isolation（仅 "worktree"）。安全限制：不支持 hooks、mcpServers、permissionMode。
版本管理：
- 设置
version字段：只在版本号变更时更新 - 不设置
version：每次 git commit 都视为新版本
LSP Plugin：配置语言服务器协议连接，让 Claude 获得跳转定义、查找引用、实时类型错误等代码智能能力。
关键细节
- Plugin 根目录标识：
.claude-plugin/plugin.json - 安装命令：
/plugin install <name>@<marketplace> - 本地测试：
claude --plugin-dir <path> - 重载：
/reload-plugins - 官方 Plugin 列表：
claude.com/plugins
关联
- plugins — Plugin 创建指南
- discover-plugins — 发现和安装 Plugin
- plugin-marketplaces — Marketplace 创建与分发
- plugin-dependencies — Plugin 依赖版本约束
实践要点
- Plugin Agent 的
isolation: "worktree"是唯一有效的 isolation 值 - LSP Plugin 需要系统已安装对应语言服务器二进制文件
- Plugin 中的 Skills 自动发现，无需额外注册
- 跨 Marketplace 依赖需要根 Marketplace 在
allowCrossMarketplaceDependenciesOn中显式允许