{
  "markdown": "# 微信小程序 AI 开发模式辅助 Skills 工具集\n\n把任意小程序源码改造为可被小程序 AI 调度的 **原子接口 + 原子组件**，并完成端到端验证与评测。\n\n## 仓库结构\n\n本仓库是一个 monorepo，包含 3 个独立 skill：\n\n| Skill | 作用 | 当前版本 |\n|---|---|---|\n| [`wxa-skills-generate`](./wxa-skills-generate/SKILL.md) | **生成**：分析小程序源码，识别业务步骤，提取网络接口与 JSAPI，生成符合微信小程序 AI 开发模式规范的技能分包（`skills/{skill-name}/`），并完成 `app.json` / `project.config.json` 集成 | 0.3.0 |\n| [`wxa-skills-validate`](./wxa-skills-validate/SKILL.md) | **校验**：对 `skills/` 产物执行\"静态校验 → 真机执行 → 渲染验证 → 交付文档\"闭环；按错误类型就地修复 skill 源文件 | 0.3.0 |\n| [`wxa-skills-eval`](./wxa-skills-eval/SKILL.md) | **评测**：端到端评测 skill 的意图理解、轨迹生成与最终答案质量；产出多维度评测报告 | 0.1.18 |\n\n## 工作流\n\n```\n小程序源码 ──▶ wxa-skills-generate ──▶ skills/ 产物 ──▶ wxa-skills-validate ──▶ 真机/渲染验证 ──▶ wxa-skills-eval ──▶ 评测报告\n```\n\n- **生成** 与 **校验** 是 skill 模式（被支持 Skills 的 IDE 加载执行），仅依赖可读的小程序源码目录\n- **评测** 是独立的 Node 工程（含 CLI / Web UI），依赖 Node ≥ 18.17\n\n## 前置要求\n\n| 项 | 说明 |\n|---|------|\n| **微信开发者工具** | 必须已安装且**已登录**（首次需扫码）。generate 的运行时探测和 validate 的真机执行/渲染验证都依赖开发者工具，开发者工具需使用 nightly 版本|\n| **服务端口** | 开发者工具内「设置 → 安全设置 → 服务端口」必须**开启** |\n\n## 快速开始\n\n### 1. 生成 skills（在支持 skills 的 coding agent 中）\n\n```\n使用 wxa-skills-generate 帮我把这个小程序的\"商品检索 + 订单管理\"做成小程序 AI 的 SKILL\n```\n\nskill 会按 6 个阶段（业务澄清 → 项目扫描 → 业务识别 → 接口提取 → 接口设计 → 代码生成 → 配置集成）输出完整的 `skills/{skill-name}/` 目录，并交棒给 `wxa-skills-validate`。\n\n> 💡 每次建议生成一小部分业务逻辑的代码，验证效果后继续生成；也可基于现有的 skills 进行扩展，完善覆盖的业务场景。\n\n详见 [`wxa-skills-generate/SKILL.md`](./wxa-skills-generate/SKILL.md)。\n\n### 2. 校验 skills\n\n```\n使用 wxa-skills-validate 校验 ./skills 目录\n```\n\nskill 会执行：\n\n1. **静态校验**（V001~V021 规则，目录结构 / `mcp.json` schema / 组件 4 文件齐全 / 组件关联页 `relatedPage` / handoff pagePath 合法性 / handoff query 参数名一致性 / 敏感接口初筛 / 体积与数量上限 / WXML 与 WXSS 禁用清单等）\n2. **真机执行**（通过微信开发者工具 CLI 跑每个原子接口，比对 `outputSchema`）\n3. **渲染验证**（截图原子组件，检查溢出、空数据、深色模式）\n4. **就地修复 + 交付文档**\n\n> 💡 三步可单独执行，不必走完整闭环。例如只想验证组件效果时：\n>\n> ```\n> 使用 wxa-skills-validate 帮我校验 ./skills 目录下的原子组件效果，使用 mock 数据验证即可，无需执行原子接口\n> ```\n\n依赖：\n\n- Node.js ≥ 18\n- 微信开发者工具已安装且 CLI 可执行（macOS 默认 `/Applications/wechatwebdevtools.app/Contents/MacOS/cli`）\n\n详见 [`wxa-skills-validate/SKILL.md`](./wxa-skills-validate/SKILL.md)。\n\n### 3. 评测\n\n为提升开发者使用体验和评测质量，小程序AI开发模式「评测工具」正在升级中，当前「评测SKILLs」暂不开放使用。后续开发者可前往[微信开放文档](https://developers.weixin.qq.com/miniprogram/dev/ai/evaluation-guide.html)或微信开发者工具使用新版「评测工具」。\n",
  "bytes": 2266,
  "sha": "82811c5c3802acd48cf21289c1861b8ef97a566e1851ebf81ed0ed83f4f5788a",
  "repo_slug": "wechat-miniprogram/ai-mode-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_wechat_miniprogram_ai_mode_skills_wxa_sk_804b4197/readme"
}