Skip to main content

快速创建与封装插件

先让插件解决一个完整问题,再决定需要加入哪些组件。

确定工作流

例如,服务巡检插件可以按获取服务状态 → 根据规则识别异常 → 输出巡检记录组织。列出每步输入、依赖与结果,再决定需要哪些技能和工具。

创建最小清单

在 .qoder-plugin/plugin.json 中填写名称与版本。以下是基础清单示例,业务能力需在后续步骤中加入。
{
  "name": "service-review",
  "version": "0.1.0",
  "description": "整理服务巡检结果"
}

加入任务所需能力

  1. 编写技能,说明巡检步骤、异常标准和结果结构。
  2. 需要实时数据时,按当前插件规范加入 MCP 配置和清单引用。
  3. 将业务规则或输出模板作为资源放入包内,并在技能中明确引用。
  4. 编写首次配置说明,列出账号、权限和运行环境要求。
技能负责工作方法,服务负责真实数据和动作,不在技能中伪造工具结果。

验证完整路径

在支持的客户端加载插件,完成首次配置并执行代表性任务。依次核对能力加载、服务连接和最终交付结果。

封装已有能力

已有 Skill 时,将其目录和引用资源加入插件,按清单规范声明路径。已有 MCP 服务时,参考MCP 封装指南。 例如,项目周报插件可由连接器读取项目数据,Skill 规定状态归纳与报告格式。先验证数据查询,再验证工作方法,最后检查两者组合后的结果;不要重复打包无关能力。 下一步:调试与打包插件