agent-plugins-skill
Installation
SKILL.md
Agent Plugins 插件开发
本技能以 Agent Plugins 1.0.0 正式规范为事实源,帮助智能体产出可移植插件,或实现符合规范的客户端。下列参考资料是中文释义和原创示例;出现分歧时,以正式规范正文为准,再参考官方 JSON Schemas。不要把本技能的版本 agent-plugins-skill、插件自身 version 与 Agent Plugins 规范版本混为一谈。
何时使用
- 插件作者:新建插件;将现有 Claude/Codex/Cursor 等专有包改造成可移植包;添加技能、MCP 服务器或客户端专有扩展。
- 客户端实现者:实现目录加载、校验、发现、MCP 连接、路径安全和故障隔离;制定一致性测试。
- 审查者:对某个真实插件或客户端逐条核对 1.0.0 要求,并给出具体修复。仅有
SKILL.md、某客户端的plugin.json或 MCP 配置,不能据此声称 Agent Plugins 兼容。
若用户只要求 Agent Skills 格式或普通 MCP 服务端开发,使用相应专门技能;这里处理二者在 Agent Plugin 包 中的组合与加载契约。
快速开始
在本技能目录下复制 examples/minimal-plugin/ 到新插件目录,按 包与 manifest修改合法 name,再把真实技能放进 skills/<名称>/SKILL.md。需要 MCP 时按 MCP 配置与运行新增根 mcp.json。先做静态校验,再在目标客户端加载;演示用远程 URL 不能当作可用服务。