一、官方权威文档（标准规范、接口 / 配置细则）

1. 小程序 AI 开发模式总指南（MCP+SKILL 架构、权限、字段、运行约束）https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html
2. 微信云开发 AI 扩展能力文档（端侧 AI 模型、流式输出、提示词配置）https://developers.weixin.qq.com/miniprogram/dev/wxcloudservice/wxcloud/guide/extensions/extend/ai.html
3. 小程序 SKILL/MCP 快速入门（开发工具联动、基础调试）https://developers.weixin.qq.com/miniprogram/dev/wxcloud/quick-start/miniprogram.html

二、细分场景实战教程（带完整代码、分步讲解）

1. 饮品点单 AI 小程序实战（SKILL.md 编写、分包配置、多意图交互）http://www.weste.net/2026/06-09/ai-mode-demo.html
2. 待办清单 SKILL 零基础实战（全配置注释、结构化返回、云数据库联动）https://cloud.tencent.com/developer/article/2685098
3. 云开发 + AI 工具联动教程（第三方 SKILL 安装、握手失败等问题排查）https://cloud.tencent.cn/developer/article/2658832?policyId=undefined

三、底层原理 & 进阶优化文档（识别逻辑、模式对比）

1. SKILL 权重与接口返回规范解析（提升 AI 识别准确率、异常返回规则）http://m.toutiao.com/group/7649262446548386314
2. AI 自动模式 / 开发模式对比（内测申请、基础库要求、风控规则）https://post.m.smzdm.com/p/a4q9qwr8/

四、高频问题排错汇总

1. AI 无法匹配 SKILL：检查manifest.json路径，AI 分包开启independent: true
2. 原子组件不渲染：组件宽高控制在 4:1~1:1 区间，仅使用 tap 点击事件，禁用滚动、长按
3. 接口调用成功但 AI 无响应：保证content字段有内容，严格遵循结构化数据格式
4. 调试正常、真机失效：小程序基础库升级至 3.15.1 及以上
5. 多分包后 AI 功能异常：主包与所有 AI 分包统一配置lazyCodeLoading

五、适配补充（uni-app 专项）

1. 借助 vite/gulp 实现编译后自动拷贝mcp.json、SKILL 目录，省去手动操作
2. 统一全项目lazyCodeLoading配置，避免编译覆盖导致功能失效
3. uni-app 自定义组件转 AI 原子组件，遵循官方样式单位、事件规范，兼容wx.modelContext上下文