微信AI能力接入全流程踩坑记录，喂饭级教程！

Q: 2.4 编写 SKILL

SKILL.md（最大16000字节）：用自然语言描述这个技能做什么、什么时候用、有什么前置条件。说白了就是给AI看的说明书。 mcp.json（最大24000字节）：声明原子接口的入参出参。 index.js：注册原子接口。 apis/myApi.js：实现业务逻辑。

ivye
免费干货
2天前
59热度
0评论

微信最近搞了个大动作：小程序AI能力。

简单说就是——把你的小程序封装成一个个 skill，用户一句话就能调用。以前要点餐得打开小程序、选菜、下单，现在直接说"我要点XXX"就完事了。

据说是微信近10年最大的变动。我第一时间跟进，折腾了一下午总算搞定…

下面把全过程分享出来，坑都帮你踩完了。

一、申请开通

登录小程序后台，找到「AI能力」然后申请开发模式。就这么简单。

二、开发步骤

2.1 下载 Nightly 版工具

下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

选最下面的「开发版 Nightly Electron Build」。别选错了，稳定版没有这个功能。

2.2 项目结构改造

把小程序的功能封装成一个个 skill，具体格式和存放目录见下图：

整个开发流程我用 Claude Code 帮忙搞定的。但是有个坑——微信AI能力刚出来，大模型根本不了解这东西，你得把官方的接入文档投喂给它，不然它瞎写。

2.3 修改 app.json

{
  "lazyCodeLoading": "requiredComponents",
  "subPackages": [
    {
      "root": "packageAgent",
      "independent": true,
      "pages": []
    }
  ],
  "agent": {
    "instruction": "AGENTS.md",
    "skills": [
      {
        "name": "my-skill",
        "description": "我的技能描述",
        "path": "packageAgent/my-skill"
      }
    ]
  }
}

2.4 编写 SKILL

SKILL.md（最大16000字节）：用自然语言描述这个技能做什么、什么时候用、有什么前置条件。说白了就是给AI看的说明书。

mcp.json（最大24000字节）：声明原子接口的入参出参。

{
  "apis": [
    {
      "name": "myApi",
      "description": "接口功能描述",
      "inputSchema": {
        "type": "object",
        "properties": {
          "param1": { "type": "string", "description": "参数说明" }
        },
        "required": ["param1"]
      },
      "outputSchema": {}
    }
  ]
}

index.js：注册原子接口。

var myApi = require('./apis/myApi')
var skill = wx.modelContext.createSkill('packageAgent/my-skill')
skill.registerAPI('myApi', myApi)

apis/myApi.js：实现业务逻辑。

async function myApi({ param1 }) {
  var res = await new Promise(function(resolve, reject) {
    wx.cloud.callFunction({
      name: 'myFunction',
      data: { param1: param1 }
    }).then(function(r) { resolve(r.result) }).catch(reject)
  })

  if (!res.success) {
    return { isError: true, content: [{ type: 'text', text: res.message }] }
  }

  return {
    content: [{ type: 'text', text: '操作成功' }],
    structuredContent: { result: res.data }
  }
}
module.exports = myApi