SuperAPI AI 工具集

agent-plugins-skill

智能体与模型

查看项目

更新于 10-15 21:47

技能介绍

用途:本技能以 Agent Plugins 1.0.0 正式规范为事实源,帮助智能体产出可移植插件或实现符合规范的客户端。适用于插件作者(新建插件、把 Claude/Codex/Cursor 等专有包改造成可移植包、添加技能或 MCP 服务器)、客户端实现者(实现目录加载、校验、发现、MCP 连接、路径安全与故障隔离)以及审查者(逐条核对 1.0.0 要求)。仅处理技能与 MCP 在 Agent Plugin 包中的组合与加载契约;若只需 Agent Skills 格式或普通 MCP 服务端开发,应使用相应专门技能。

主要能力:区分静态结构与 Schema 检查、客户端加载测试、实际 MCP 握手/工具调用、目标宿主安装验证四个层面,一层成功不替代另一层。规范中 MUST/MUST NOT 为一致性要求,SHOULD/RECOMMENDED 为建议,MAY 为允许,不得把建议升级为硬性失败。资料导航涉及 package-and-manifest.md、skills-and-extensions.md、mcp-servers.md、client-implementation.md、examples.md、sources-and-compatibility.md。

使用方式:复制 examples/minimal-plugin/ 到新插件目录,按包与 manifest 修改合法 name,把真实技能放进 skills/<名称>/SKILL.md;需要 MCP 时新增根 mcp.json,先静态校验再在目标客户端加载。客户端实现按顺序:目录根与真实路径边界 → 校验 plugin.json → 发现支持的固定组件 → 各级故障隔离 → 可选扩展处理,至少实现技能或 MCP 之一,MCP 至少支持 stdio 或 streamable-http 之一;客户端运行时不得在线抓取 Schema。审查输出需逐项给出通过/不符合/未验证/不适用及证据。

限制:不要把 agent-plugins-skill 版本、插件自身 version 与规范版本混为一谈;示例中的服务地址和命令仅用于演示,运行前必须替换;仅有 SKILL.md、某客户端 plugin.json 或 MCP 配置不能声称 Agent Plugins 兼容。