SuperAPI AI 工具集

writing-plugins

编程与开发

查看项目

更新于 10-16 07:18

技能介绍

用途:该资料讲解插件(plugin)的设计与架构,示例基于 Claude Code 布局(.claude-plugin/plugin.json 加自动发现的 commands/、agents/、skills/、hooks/),同一套产物选择与架构推理也适用于其他工具,差异仅在清单路径与打包方式。

主要能力与内容:说明插件是命令、智能体、技能、钩子的集合,先决定需要哪些产物。给出产物选择指南(用户执行斜杠命令用 Command,AI 自主工作用 Agent,领域知识用 Skill,事件自动触发用 Hook,外部服务集成用 MCP server)。介绍最小可用插件结构,以及多种架构模式:单命令、命令加单智能体、命令加多智能体并行、命令加智能体顺序流水线、仅钩子,并给出选择矩阵。

清单与结构:plugin.json 仅 name 为必填,推荐 version、description、author、license、keywords、category。列出完整目录布局与命名约定:命令与智能体用 kebab-case,技能为 kebab-case 目录下的 SKILL.md,钩子脚本用 kebab-case,scripts/ 不被自动发现。版本遵循 semver,升级需同步四处(插件清单、插件市场条目、中央市场清单、中央市场 README 表格)。CLAUDE.md 面向 AI,写架构与产物关系;README 面向用户。重复逻辑可提取到 commands/shared/*.md 并设 user-invocable: false,但仅在有 3 个以上消费者时提取。

用法与发布:测试包括 claude plugin validate /path/to/plugin 校验结构、测试命令无参数与边界情况、测试智能体触发、钩子脚本与 fail-open。发布流程为推送插件仓库、在中央 marketplace.json 添加条目、在中央 README 版本表添加行、提交并推送,最后用 claude plugin install my-plugin@xiaolai --scope project 验证。

限制:资料未提供具体收费、价格或效果数据;跨工具部分仅简要提到 Codex CLI、Antigravity 与 npx skills add,细节需参考相应约定文档。常见错误包括命令职责过多、智能体缺少示例、技能超 500 行、硬编码路径、版本未同步四处等。