Plugin Development Guide 是一个面向 Claude Code 插件开发的元技能,主要作用是提供插件开发概览,并根据用户当前任务路由到相应的专门技能。
用途 该技能在用户询问 Claude Code 插件、插件开发、如何构建插件、存在哪些插件组件等主题时启用。它本身不直接完成全部开发工作,而是作为入口和索引,帮助定位到合适的专项技能。
主要能力 插件开发工具包提供 9 个专门技能,再加上本指南。每个技能处理插件开发的一个特定领域:
- plugin-structure:目录布局、清单、组件组织。
- command-development:简单提示词,即 commands/ 中的单个 .md 文件。
- agent-development:自主子代理。
- skill-development:带捆绑资源的复杂提示词,位于 skills/。
- hook-development:事件驱动自动化。
- mcp-integration:Model Context Protocol 服务器。
- lsp-integration:用于代码智能的 Language Server Protocol。
- plugin-settings:通过 .local.md 进行用户配置。
- marketplace-structure:插件市场创建。
何时使用各技能
- 开始新插件时使用 plugin-structure,适用于从头创建插件、理解插件目录布局、配置 plugin.json 清单、了解组件自动发现、使用 ${CLAUDE_PLUGIN_ROOT} 实现可移植路径。
- 添加面向用户的命令时使用 command-development,适用于创建斜杠命令(/command-name)、配置命令 frontmatter(description、allowed-tools、model)、使用动态参数($ARGUMENTS、$1、$2)、用 @ 语法引用文件、用 [BANG] 反引号内联执行 bash。
- 创建自主代理时使用 agent-development,适用于创建处理复杂任务的子代理、编写代理系统提示词、配置代理触发条件(带示例的 description)、选择代理模型和颜色、限制代理工具访问。
- 构建技能时使用 skill-development,适用于创建扩展 Claude 能力的技能、编写带正确 frontmatter 的 SKILL.md、用渐进式披露组织技能内容、创建 references/、examples/、scripts/ 目录、编写有效的触发短语。
- 实现事件钩子时使用 hook-development,适用于响应 Claude Code 事件(PreToolUse、Stop、SessionStart 等)、创建基于提示词或基于命令的钩子、在执行前验证工具输入、强制完成标准、阻止危险操作。
- 通过 MCP 集成外部服务时使用 mcp-integration,适用于向插件添加 MCP 服务器、配置 stdio、SSE、HTTP 或 WebSocket 服务器、设置身份验证(OAuth、令牌)、在命令和代理中使用 MCP 工具、在 PulseMCP 上发现现有 MCP 服务器。
- 通过 LSP 添加代码智能时使用 lsp-integration,适用于向插件添加 Language Server Protocol 服务器、启用转到定义和查找引用、配置特定语言的服务器(pyright、gopls、rust-analyzer)、设置 extensionToLanguage 映射、增强 Claude 的代码理解。
- 管理插件配置时使用 plugin-settings,适用于存储用户可配置设置、使用 .claude/plugin-name.local.md 模式、在钩子中解析 YAML frontmatter、创建临时激活的钩子、管理代理状态。
- 创建插件市场时使用 marketplace-structure,适用于为多个插件创建市场、配置 marketplace.json、设置插件来源(相对路径、GitHub、git URL)、向团队分发插件、组织插件集合。
技能选择决策树 用户想要… ├── 创建/组织插件结构? → plugin-structure ├── 添加简单斜杠命令(无捆绑资源)? → command-development ├── 创建自主代理? → agent-development ├── 添加带脚本/引用的复杂技能? → skill-development ├── 响应 Claude Code 事件? → hook-development ├── 集成外部服务/API? → mcp-integration ├── 添加代码智能/LSP? → lsp-integration ├── 让插件可配置? → plugin-settings └── 分发多个插件? → marketplace-structure
常见多技能工作流
- 构建完整插件:先加载 plugin-structure 创建目录布局;加载 command-development 添加面向用户的命令;加载 hook-development 实现事件驱动行为;如需要用户配置则加载 plugin-settings;使用 plugin-validator 代理验证结构。
- 创建由 MCP 驱动的插件:先加载 plugin-structure 获得基本结构;加载 mcp-integration 配置 MCP 服务器;加载 command-development 创建使用 MCP 工具的命令;加载 agent-development 实现自主 MCP 工作流。
- 构建代码智能插件:先加载 plugin-structure 获得基本结构;加载 lsp-integration 配置语言服务器;加载 command-development 创建使用 LSP 功能的命令。
- 构建以技能为核心的插件:先加载 plugin-structure 获得基本结构;加载 skill-development 创建专门技能;使用 skill-reviewer 代理验证技能质量。
可用代理 plugin-dev 插件还提供 3 个代理:
- plugin-validator:验证插件结构和清单。
- skill-reviewer:审查技能质量和触发。
- agent-creator:根据描述生成新代理。 创建组件后可主动使用这些代理以确保质量。
可用命令
- /plugin-dev:plugin-dev-guide:概览与技能路由。
- /plugin-dev:start:入口点,选择插件或市场创建。
- /plugin-dev:create-plugin:8 阶段引导式插件创建工作流。
- /plugin-dev:create-marketplace:8 阶段引导式市场创建工作流。
用户请求处理 $ARGUMENTS 如果用户在上方提供了请求,则分析并执行以下之一:若请求明确匹配某一领域,路由到特定技能;使用本指南的概览信息直接回答;若请求含糊,请求澄清。如果未提供请求,则概述可用的插件开发能力,并询问用户想要构建或了解什么。
使用方式与限制 该技能作为元技能使用,通过命令 /plugin-dev:plugin-dev-guide 访问,并根据任务路由到上述专项技能。关于收费、价格、具体平台支持范围等信息,资料中暂未提供。