用途:在已有小程序项目中创建新的 AI Skill,适用于用户想在现有项目里添加自定义 AI 能力、而非安装社区 Skill 的场景。职责包括理解需求、设计原子接口、产出 SKILL.md 与 mcp.json 设计文档、调用生成与校验工具完成代码生成与验证、修复问题直至通过。它不负责创建新小程序项目、不搜索安装社区 Skill、不修改小程序主包代码、不上架应用市场;交付物为 skills/{skill-name}/ 完整分包及 app.json 注册。
主要能力与规范:接口以 camelCase 命名,职责单一,一个 Skill 建议 3-6 个原子接口;description 需含前置条件与严禁场景。mcp.json 去除 outputSchema 后不超过 24000 字符,SKILL.md 不超过 16KB。带 UI 的接口需关联 _meta.ui.componentPath,组件遵循 WeCard 设计规范。
使用方式:项目需已存在 skills/ 目录并执行过 npx mp-skills setup,不得覆盖已有同名 Skill 目录。流程为需求理解与接口设计、产出设计文档并让用户确认、通过 npx mp-skills --help 获取工具路径后调用 wxa-skills-generate 生成代码,再用 node <validate-dir>/scripts/validate.mjs <project-path> 静态校验,随后对带 UI 的接口执行 execute.mjs 与 render.mjs,失败则按修复流程处理并重跑。安装命令为 npx skills add TencentCloudBase/mp-skills -s wxa-create-mp-skill。
限制:功能若已存在于社区 Skill 应优先安装;需求超过 6 个接口应拆分;连续 3 轮校验未通过需请求用户确认;能力无法实现时终止并告知。部分细节(环境兼容性、耗时等)暂未提供。