微信小程序AI开发模式校验

微信小程序AI开发模式产物的校验挑战

在微信小程序开发中，使用AI模式生成的SKILLs产物（如技能包）需要经过严格的校验才能投入使用。这些产物包括mcp.json、接口代码、组件文件等，但存在静态配置错误、接口执行失败、组件渲染异常或交付文档缺失等问题。手动验证耗时且易遗漏，特别是当多个技能分包、敏感接口需要特殊处理时，缺乏统一工具会导致开发流程碎片化。

核心校验流程

本技能提供闭环校验机制，覆盖从静态检查到真机验证的全链路：

• 静态校验：自动扫描技能分包，执行V001-V019规则（如Schema一致性、组件绑定），生成校验报告并分类错误类型（如T1命名错误、T5合规性违规）。
• 原子接口执行：通过微信开发者工具CLI执行接口，确保status === "ok"且invokeResult.isError !== true。敏感接口（如可能产生副作用的）由destructive-manifest.json管控，默认跳过执行，仅在用户确认时带--confirm-destructive运行。
• 原子组件渲染：对带_meta.ui.componentPath的接口，执行render并完成5项核对（如生命周期日志、溢出检测），确保组件在真机上正常渲染。
• 交付文档生成：校验通过后，生成DELIVERY.md交付模板，汇总结果。

执行过程中，技能按拓扑序安排接口调用（无参接口优先），维护数据池传递参数，并在失败时按错误类型自动修复（如T2对齐字段、T3调整绑定）。迭代规则限制修复轮数，避免无限循环。

适用边界与注意事项

• 环境依赖：需Node.js ≥ 18、微信开发者工具已安装且CLI可用；项目必须配置project.config.json（含appid）和app.json（含agent.skills）。
• 敏感接口处理：命中敏感关键词的接口由V019初筛，需模型判断后编辑destructive-manifest.json；未明确放行的接口默认拦截，确保安全。
• 校验严格性：静态编译通过≠验收通过；必须真机执行和渲染，且单接口连续修复3轮不通过才允许挂起。
• 局限性：不适用于主包代码校验；依赖CLI稳定性，工具超时需手动处理；产物目录cli-agent-run/会被自动添加到忽略列表，避免开发工具干扰。

使用时应逐步完成各阶段，并参考references/CLI_AGENT_REFERENCE.md处理复杂场景。