SuperAPI AI 工具集

component-patterns

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:帮助开发者在构建 Claude Code 插件时,判断某项需求应实现为哪种组件类型,并规划组件的目录组织与扩展方式。

主要能力:

  1. 组件生命周期说明。组件分发现阶段与激活阶段:发现阶段在 Claude Code 启动时读取 .claude-plugin/plugin.json、扫描默认与自定义路径、解析 YAML frontmatter 与配置文件、注册组件并初始化 MCP 服务器与 hooks;发现只在初始化时发生一次,启动后新增组件需重启会话。激活阶段按类型不同:Command 由用户输入 /command 触发,Skill 由任务描述匹配触发,Agent 由能力匹配触发,Hook 由系统事件匹配触发,MCP Server 由工具调用匹配触发。
  2. 组件选择决策树。需要拦截或校验工具调用与事件时用 Hook;需要经 API 或外部进程提供外部工具访问时用 MCP Server;需要独立身份、工具、模型或权限范围时用 Agent;属于领域知识、工作流或流程指南时用 Skill;仅需用户触发的简单 bash 动作时用 Command(旧式,新工作优先用 Skill)。
  3. 安全限制。插件内随附的 Agent 安全配置受限:frontmatter 中的 hooks 在运行时被静默忽略,mcpServers 不受支持,permissionMode 被忽略;直接安装的 Agent(.claude/agents/ 或 ~/.claude/agents/)支持全部 frontmatter 字段。若 Agent 需要 hooks、MCP 声明或自定义权限模式,必须直接安装而非随插件分发。
  4. 组织模式。Command 分扁平(约 15 个以内)、分类(15 个以上)、层级(20 个以上);Agent 分基于角色、基于能力、基于工作流;Skill 分基于主题、基于工具、基于工作流、富资源(SKILL.md + references/ + scripts/ + assets/);Hook 分单体、基于事件、基于用途。跨组件模式包括通过插件根目录 lib/ 共享资源(脚本中用 ${CLAUDE_PLUGIN_ROOT}/lib/ 访问)、分层架构(commands/agents/skills/lib 分层)、模块化扩展(在 plugin.json 的 commands 与 agents 字段注册扩展路径,字段接受字符串或数组并替换默认扫描,需保留的默认路径组件必须一并列出)。

使用方式:按决策树选定组件类型后,用对应创建技能:Hook 用 /plugin-creator:hook-creator,Agent 用 /plugin-creator:agent-creator,Skill 用 /plugin-creator:skill-creator,MCP 用 /fastmcp-creator,Command 用 /plugin-creator:command-development。相关技能还包括 /plugin-creator:plugin-lifecycle、/plugin-creator:claude-plugins-reference-2026、/plugin-creator:plugin-settings、/plugin-creator:shared-content-references。

适用场景:Claude Code 插件设计与重构、组件类型选型、大型插件(100+ 文件)的目录规划。

限制:发现仅在启动时执行一次;插件内 Agent 不支持 hooks、mcpServers、permissionMode;引用内容需确认在运行环境中存在,否则应内联、打包、加保护或删除。具体收费、价格与平台信息暂未提供。