字
字节笔记本
2026年6月14日
ai-mode-skills — 微信小程序 AI 开发模式官方辅助工具集
API中转
¥120
本文介绍微信小程序团队开源的 ai-mode-skills 工具集，它能把任意小程序源码改造为可被小程序 AI 调度的原子接口 + 原子组件，并完成端到端验证与评测，是微信小程序 AI 开发模式的核心基础设施。
项目简介
ai-mode-skills 是微信官方开源的小程序 AI 开发模式辅助工具集，由微信小程序团队（wechat-miniprogram）开发维护。截至目前，该项目在 GitHub 上已获得 102 stars，主要使用 HTML 和 JavaScript 编写，采用 MIT 许可证。
项目定位非常明确：把任意小程序源码改造为可被小程序 AI 调度的原子接口 + 原子组件，并完成端到端验证与评测。它解决了小程序接入 AI 模式时最核心的痛点——如何将现有业务代码高效、规范地转化为 AI 可调度的 SKILL。
核心特性
- 一键生成 SKILL：
wxa-skills-generate自动分析小程序源码，识别业务步骤，提取网络接口与 JSAPI，生成符合微信小程序 AI 开发模式规范的技能分包 - 全自动校验闭环：
wxa-skills-validate执行"静态校验 → 真机执行 → 渲染验证 → 交付文档"完整闭环，按错误类型就地修复 - 端到端评测：
wxa-skills-eval提供 CLI 和 Web UI 两种评测方式，多维度评估 SKILL 的意图理解、轨迹生成与答案质量 - Monorepo 架构：三个独立 SKILL 各司其职，可独立使用也可串联成完整工作流
- 微信开发者工具深度集成：真机执行和渲染验证均通过微信开发者工具 CLI 完成
技术栈
- Node.js — 三个 SKILL 工具的运行环境，依赖 Node ≥ 18
- HTML / JavaScript — 主要编程语言，Web UI 评测界面使用 HTML
- pnpm — 包管理工具（评测模块使用）
- 微信开发者工具 CLI — 真机执行和渲染验证的底层依赖
仓库结构
项目是一个 monorepo，包含 3 个独立 SKILL：
| SKILL | 作用 | 当前版本 |
|---|---|---|
| wxa-skills-generate | 生成：分析小程序源码，识别业务步骤，提取网络接口与 JSAPI，生成符合规范的技能分包 | 0.1.19 |
| wxa-skills-validate | 校验：对 skills/ 产物执行静态校验 → 真机执行 → 渲染验证 → 交付文档闭环 | 0.1.18 |
| wxa-skills-eval | 评测：端到端评测 skill 的意图理解、轨迹生成与最终答案质量 | 0.1.18 |
安装指南
前置要求
- Node.js ≥ 18
- 微信开发者工具（nightly 版本）已安装且已登录
- 开发者工具内「设置 → 安全设置 → 服务端口」必须开启
快速开始
bash
# 克隆仓库
git clone https://github.com/wechat-miniprogram/ai-mode-skills.git
cd ai-mode-skills使用示例
1. 生成 SKILL
在支持 SKILL 的 coding agent 中，使用 wxa-skills-generate 将小程序的业务逻辑生成为 AI 可调度的 SKILL：
使用 wxa-skills-generate 帮我把这个小程序的"商品检索 + 订单管理"做成小程序 AI 的 SKILL
SKILL 会按 6 个阶段（业务澄清 → 项目扫描 → 业务识别 → 接口提取 → 接口设计 → 代码生成 → 配置集成）输出完整的 skills/{skill-name}/ 目录。
2. 校验 SKILL
bash
# 使用 wxa-skills-validate 校验 ./skills 目录校验包含三个步骤：
- 静态校验（V001~V016 规则）：检查目录结构、mcp.json schema、组件 4 文件齐全、relatedPage 路径合法、WXSS 禁用清单等
- 真机执行：通过微信开发者工具 CLI 跑每个原子接口，比对 outputSchema
- 渲染验证：截图原子组件，检查溢出、空数据、深色模式
三步可单独执行，例如只想验证组件效果时：
使用 wxa-skills-validate 帮我校验 ./skills 目录下的原子组件效果，使用 mock 数据验证即可，无需执行原子接口
3. 评测 SKILL
bash
cd wxa-skills-eval
pnpm install
pnpm dev:web # 启动 Web UI 评测
# 或
pnpm dev # 启动 CLI 评测核心概念
| 术语 | 说明 |
|---|---|
| 原子接口 | 对外暴露给小程序 AI 的可调用能力，路径 skills/{skill}/apis/{name}.js |
| 原子组件 | 用于渲染原子接口返回数据的 UI，路径 skills/{skill}/components/{name}/index.{js,json,wxml,wxss} |
| mcp.json | 单一来源维护接口契约（name / description / inputSchema / outputSchema / _meta.ui.componentPath）+ 组件配置 |
| wx API 白名单 | 接口侧 vs 组件侧可用 wx API 范围 |
工作流
text
小程序源码 ──▶ wxa-skills-generate ──▶ skills/ 产物 ──▶ wxa-skills-validate
──▶ 真机/渲染验证 ──▶ wxa-skills-eval ──▶ 评测报告- 生成 与 校验 是 SKILL 模式（被支持 SKILLS 的 IDE 加载执行），仅依赖可读的小程序源码目录
- 评测 是独立的 Node 工程（含 CLI / Web UI），依赖 Node ≥ 18.17
项目链接
- GitHub 仓库：wechat-miniprogram/ai-mode-skills
- 许可证：MIT License
- 贡献者：6 人（@Axx-03、@osmanthuspeace、@linkaifan、@seasonhuang、@SgLy、@wechat-miniprogram-admin）
分享: