SuperAPI AI 工具集

plugin-development

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:该技能用于指导创建有效的 Claude Code 插件,涵盖技能(skills)、命令(commands)、智能体(agents)和钩子(hooks)四类组件的编写。

插件结构:插件目录包含 .claude-plugin/plugin.json 作为元数据,以及 skills/、commands/、agents/、hooks/ 等子目录;技能目录下有 SKILL.md(必需)、references/、examples/、scripts/。

主要能力:

  1. 技能开发:SKILL.md 需带 YAML frontmatter(name、description、version),正文建议 1,500-2,000 词。description 要写明具体触发短语,采用第三人称。采用渐进式披露:元数据始终加载,SKILL.md 在触发时加载,参考资料按需加载。写作使用祈使句而非第二人称。
  2. 命令开发:命令文件含 name、description 及可选的 argument-hint 参数提示,正文写执行指令。
  3. 智能体开发:含 description(带使用示例)、model、tools、color(red/green/yellow/blue/magenta/cyan/white)及行为说明。
  4. 钩子开发:hooks.json 定义 event(SessionStart、PreToolUse、PostToolUse、Stop、Notification)、matcher、type、prompt、timeout。

使用方式:按上述结构组织文件,并对照校验清单检查:技能的 frontmatter 合法、描述含触发短语、正文词数合适、引用文件存在;命令有名称与描述;智能体有示例、模型、工具与有效颜色;钩子事件配置正确。

限制与常见错误:描述过于笼统、SKILL.md 内容过多、使用第二人称、缺少资源引用、智能体示例含糊。资料未提供安装命令、收费或平台信息。