微信小程序AI开发模式生成器

问题背景

将现有微信小程序业务迁移到小程序AI开发模式（wx.modelContext 规范）时，开发者常面临手动重构代码的挑战。这包括从源码中识别业务接口、确保只使用白名单内的 JSAPI、将逻辑封装为独立分包，以及处理鉴权迁移等复杂任务。手动操作耗时且易出错，尤其需要严格遵守一系列硬性约束（如禁止 getApp()、依赖主包等），否则分包可能无法正确加载或执行。

核心流程

本技能通过自动化流程解决上述问题，将源码转换为符合 wx.modelContext 规范的技能分包。主要步骤包括：

• 源码分析与业务识别：扫描小程序源码，识别业务流程、接口和 JSAPI 调用，生成 interface-spec 作为蓝图。
• 接口提取与原子接口设计：从源码中提取网络请求和 JSAPI 调用，设计对外暴露的原子接口（路径如 skills/{skill}/apis/{name}.js），并处理鉴权参数迁移。
• 运行时探测（probe）：使用 miniprogram-automator 在源项目上触发请求，捕获真实响应结构，确保生成代码的准确性。
• 代码生成与配置集成：基于模板生成分包代码（包括 mcp.json、SKILL.md、index.js 等），同时更新 app.json 和 project.config.json，确保独立分包可加载。
• 生成内自检：执行产物存在性检查、字段忠实自检和鉴权自检，为后续校验阶段做准备。

适用边界与注意事项

本技能适用于有可读源码的微信小程序项目，但需注意：

• 依赖环境：需要完整源码目录、微信开发者工具及 scripts/probe.mjs，仅提供 appid 或截图将触发阻断。
• 硬性约束：生成分包必须遵循独立性原则，如禁止引用主包代码（需内联依赖）、自行处理登录态和初始化；同时严格遵守 wx API 白名单（接口侧和组件侧），非白名单 JSAPI 将导致阻断或功能替代。
• 交付产物：生成 skills/{skill}/ 目录及配置更新，但组件仅在用户明确要求时生成；原子接口默认只返回文本和数据，通过 handoff 接力页进入小程序业务。
• 校验隔离：生成阶段的自检不等同于产物校验，静态规则校验和真机测试由 wxa-skills-validate 负责，确保职责分离。

总之，该技能旨在忠实迁移源码逻辑，而非重写，适用于希望快速接入小程序AI开发模式的工程化场景。