Plugin Structure 说明文档

# 插件结构技能 关于 Claude Code 插件架构、目录布局和最佳实践的综合指南。 ## 概述 本技能提供以下详细知识： - 插件目录结构与组织 - `plugin.json` 清单配置 - 组件组织（命令、智能体、技能、钩子） - 自动发现机制 - 使用 `${CLAUDE_PLUGIN_ROOT}` 的可移植路径引用 - 文件命名规范 ## 技能结构 ### SKILL.md (1,619 字) 涵盖以下核心技能内容： - 目录结构概述 - 插件清单 (plugin.json) 字段 - 组件组织模式 - ${CLAUDE_PLUGIN_ROOT} 使用方法 - 文件命名规范 - 自动发现机制 - 最佳实践 - 常见模式 - 故障排除 ### 参考资料 深入研究的详细文档： - **manifest-reference.md**: 完整的 `plugin.json` 字段参考 - 所有字段描述与示例 - 路径解析规则 - 验证指南 - 最小化与完整清单示例 - **component-patterns.md**: 高级组织模式 - 组件生命周期（发现、激活） - 命令组织模式 - 智能体组织模式 - 技能组织模式 - 钩子组织模式 - 脚本组织模式 - 跨组件模式 - 可扩展性最佳实践 ### 示例 三个完整的插件示例： - **minimal-plugin.md**: 最简单的插件 - 单个命令 - 最小化清单 - 何时使用此模式 - **standard-plugin.md**: 结构良好的生产级插件 - 多个组件（命令、智能体、技能、钩子） - 带有元数据的完整清单 - 丰富的技能结构 - 组件间的集成 - **advanced-plugin.md**: 企业级插件 - 多层级组织 - MCP 服务器集成 - 共享库 - 配置管理 - 安全自动化 - 监控集成 ## 此技能触发时机 当用户执行以下操作时，Claude Code 会激活此技能： - 要求“创建插件”或“脚手架插件” - 需要“了解插件结构” - 想要“组织插件组件” - 需要“设置 plugin.json” - 询问关于“${CLAUDE_PLUGIN_ROOT}”的使用 - 想要“添加命令/智能体/技能/钩子” - 需要“配置自动发现”帮助 - 询问关于插件架构或最佳实践 ## 渐进式披露 该技能使用渐进式披露来管理上下文： 1. **SKILL.md** (~1600 字): 核心概念与工作流 2. *