Agent Skills
返回列表
小程序 AI 技能创建

小程序 AI 技能创建

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/wxa-create-mp-skill。

技能介绍

要解决什么问题

在 mp-skills 体系里,每个业务能力以独立分包形式挂在 skills/{skill-name}/ 下,并靠 SKILL.md(AI 路由)与 mcp.json(模型可调用声明)对外暴露。团队往往已有小程序壳工程,却缺少一条从「聊清楚需求」到「可校验、可渲染的完整分包」的流水线;若手工搭目录、对齐 WeCard 与 wx API 白名单,还容易在注册、Schema 与组件绑定上反复踩坑。

技能如何工作

本技能负责在已有小程序项目中新建一个 AI Skill,边界清晰:

  • Step 1:与用户对话,把需求拆成 3~6 个职责单一的原子接口(camelCase 命名,路径约定 skills/{skill}/apis/{name}.js),输出接口清单并确认。
  • Step 2:在 skills/{skill-name}/ 下产出 SKILL.md(触发场景、不适用范围、使用顺序,≤ 16KB)与 mcp.json(去除 outputSchema 后 ≤ 24000 字符),含前置条件与严禁场景;确认后才继续。
  • Step 3:记录 npx mp-skills --help 中的 wxa-skills-generate / wxa-skills-validate 路径,按 generate 技能的阶段式流程生成接口、原子组件(components/{name}/index)及分包配置。
  • Step 4~5:静态校验(summary.errors === 0 且 buildStatus === "pass"),再对带 _meta.ui.componentPath 的接口做执行与渲染;失败则按 T1~T-build 等类型修复并重跑,连续 3 轮仍失败则标记疑难。
  • Step 6:确认 app.json 的 agent.skills[] 已注册,并提示执行 npx mp-skills setup。

交付物为 skills/{skill-name}/ 完整分包 及 app.json 注册,不改动主包页面逻辑。

适用边界与注意点

  • 前置:项目须已有 skills/ 目录且已跑过 npx mp-skills setup;不得覆盖同名 Skill 目录。
  • 不做:新建小程序项目(wxa-create-ai-miniprogram)、社区 Skill 搜索安装(wxa-find-skills)、改 app.js/主包页面、上架应用市场。
  • 阻断:社区已有同类能力应建议安装而非重复造轮子;接口超过 6 个应拆多个 Skill;需求在硬约束下无法实现应明确终止并给替代方案。

使用场景

  • 已有 mp-skills 工程,产品要新增一块可被 AI 调用的业务能力(如查单、下单),需在 skills/ 下新建独立分包并完成注册
  • 业务方口述流程后,需先拆成 3~6 个 camelCase 原子接口,并写出含触发场景与严禁场景的 SKILL.md、mcp.json 再生成代码
  • generate 产出接口与 WeCard 组件后,静态校验或 execute/render 报错,需按 V001~V016 规则逐项修复直至 build 通过
  • 确认社区里没有可安装的同类 Skill,决定在现有小程序里自建分包,且不能改动 app.js 与主包页面

适合人员

  • 维护公司 mp-skills 单体仓库、需在不动主包页面的前提下为新业务线追加 Skill 分包的小程序工程师
  • 已执行 npx mp-skills setup,要把产品文档里的下单/检索流程落成 mcp.json 与可渲染原子组件的 CloudBase 接入同学
  • 负责 Agent 能力规划、需把「一个接口一件事」的接口清单与前置条件写进 description 再交给生成链路的技能设计者
  • 校验阶段频繁遇到 Schema 与组件 setData 不一致,需要按 T1~T8 分类改 apis、mcp.json 与 components 的修复执行者