Skip to main content

插件规范

插件通过清单描述自身身份与能力,通过目录组织技能、服务配置和资源。
my-plugin/
├─ .qoder-plugin/
│  └─ plugin.json
├─ skills/
│  └─ my-skill/
│     └─ SKILL.md
├─ mcp.json
└─ README.md

插件清单

.qoder-plugin/plugin.json 是插件清单。名称用于标识插件,版本用于区分交付内容;资源路径声明应指向包内实际文件。 具体字段与当前解析规范一致,不从其他平台复制清单后直接提交。

技能与服务配置

skills/ 中的技能定义任务方法;mcp.json 按需声明 MCP 服务连接。只有技能的插件不需要为了凑结构加入服务配置。 如果插件依赖外部账号,请写清授权和配置方法,不要将你的个人凭证打包。

资源与说明

根据任务加入模板、参考资料和必要脚本;使用说明应涵盖用途、前置条件、首次配置和已知限制。

能力、依赖与权限

请核对清单引用的文件,并在使用说明中写清技能和工具的依赖及首次授权步骤。安装、卸载和撤销授权的行为以客户端说明为准;卸载插件后,外部服务的授权可能仍需单独撤销。

版本与交付检查

版本信息需与本次内容一致,兼容性要求需有目标客户端验证依据。ZIP 根目录直接包含 .qoder-plugin/ 等内容,不额外嵌套外层目录。详细定位方法见调试与打包。 下一步:开发一个插件;已有 MCP 服务可阅读封装指南。