component-patterns

# 组件组织模式 用于有效组织插件组件的高级模式。 ## 组件生命周期 ### 发现阶段 当 Claude Code 启动时： 1. **扫描已启用的插件**：读取每个插件的 `.claude-plugin/plugin.json` 2. **发现组件**：查看默认路径和自定义路径 3. **解析定义**：读取 YAML 元数据和配置 4. **注册组件**：使其对 Claude Code 可用 5. **初始化**：启动 MCP 服务器，注册钩子 (Hooks) **时机**：组件注册发生在 Claude Code 初始化期间，而非持续进行。 ### 激活阶段 当使用组件时： **命令**：用户输入斜杠命令 → Claude Code 查找 → 执行 **智能体**：任务到达 → Claude Code 评估能力 → 选择智能体 **技能**：任务上下文匹配描述 → Claude Code 加载技能 **钩子**：事件发生 → Claude Code 调用匹配的钩子 **MCP 服务器**：工具调用匹配服务器能力 → 转发给服务器 ## 命令组织模式 ### 平铺结构 所有命令位于单个目录中： commands/ ├── build.md ├── test.md ├── deploy.md ├── review.md └── docs.md **适用场景**： - 总计 5-15 个命令 - 所有命令处于相同的抽象级别 - 没有明确的分类 **优点**： - 简单，易于导航 - 无需配置 - 发现速度快 ### 分类结构 针对不同命令类型使用多个目录： commands/ # 核心命令 ├── build.md └── test.md admin-commands/ # 管理命令 ├── configure.md └── manage.md workflow-commands/ # 工作流自动化 ├── review.md └── deploy.md **清单配置**： { "commands": [ "./commands", "./admin-commands", "./workflow-commands" ] } **适用场景**： - 15 个以上命令 - 具有明确的功能分类 - 不同的权限级别 **优点**： - 按用途组织 - 更易于维护 - 可按目录限制访问权限 ### 层级结构 针对复杂插件的嵌套组织： commands/ ├── ci/ │ ├── build.md │ ├── test.md │ └── lint.md ├── deployment/ │ ├── staging.md │ └── production.md └── management/ ├── config.md └── status.md **注意**：Claude Code 不支持自动发现嵌套命令。请使用自定义路径： { "commands": [ "./commands/ci", "./commands/deployment", "./commands/management" ] } **适用场景**： - 20 个以上命令 - 多级分类