前言¶
用 AI 生成微信小程序 SKILL 产物时，常见问题不在「能不能写出来」，而在「能不能过校验、能不能在真机上跑通」。目录结构、原子接口、组件渲染各有一套约束，单靠人工对照文档逐项检查成本高，也容易漏项。
下面介绍微信小程序团队发布的 Skill @tencent-adm/wxa-skills-validate（微信小程序 AI 开发模式校验 Skills）。它面向小程序 AI SKILLs 产物的校验与修复，并依托微信开发者工具做真机验证，把静态检查、接口联调与交付文档串成一条可重复的路径。
这是什么¶
一句话定位：校验和修复小程序 AI SKILLs 产物，并在需要时输出交付文档。
- 出品 / 维护：微信小程序团队（SkillHub 来源标注为 enterprise）
- 坐标：
@tencent-adm/wxa-skills-validate - 当前版本：v0.2.3
- SkillHub 分类：dev-programming
- 标签：
requires_api_key=false（按页面说明，不依赖 API Key）
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/wxa-skills-validate
- API 坐标页：https://api.skillhub.cn/tencent-adm/wxa-skills-validate
核心功能¶
以下能力均来自官方简介，未在资料中出现的细节不展开。
-
对
skills/目录做静态校验
在产物落盘后，先检查目录与 SKILL 相关结构是否符合预期，减少后续联调阶段的返工。 -
跑通原子接口
在静态校验之后，验证原子层接口能否按预期调用，避免「文件齐全但运行时失败」。 -
验证原子组件渲染
覆盖 UI / 组件侧：确认原子组件能否正确渲染，而不只停留在接口返回。 -
修复校验报错
校验失败时，由 Agent 按 Skill 指引定位并修复报错项，而不是只输出错误列表。 -
输出交付文档
在流程末尾整理交付说明，便于团队交接或归档。 -
真机验证
依托微信开发者工具进行真机验证，把「开发者工具内通过」与「真机行为」对齐。
安装与启用¶
SkillHub 页面给出的安装方式是：让 AI 按通用安装文档安装本 Skill。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/wxa-skills-validate`。
若本机已安装 SkillHub CLI，可按官方文档将技能装到当前 Agent 识别的 skills 目录（安装时必须使用 --dir，否则默认落在 ./skills/ 可能不被识别）：
command -v skillhub && skillhub --version
未安装 CLI 时，完整安装（CLI + 默认 Skill）示例：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill（将 <skills 目录> 换成你当前环境的路径）：
skillhub install tencent-adm/wxa-skills-validate --dir <skills 目录>
常用客户端 skills 目录（摘自 SkillHub 安装文档，以你本机实际配置为准）：
| 客户端 | 典型路径 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按所用 Agent 的要求重启或刷新技能列表，再在对话中触发下文场景即可。
典型用法¶
官方简介将触发场景写得很明确，可按下面顺序在 Agent 里提出需求（表述可与项目实际对齐，不必逐字照搬）：
- 静态校验：「对当前项目的
skills/目录做静态校验。」 - 原子接口：「跑通 SKILL 相关的原子接口。」
- 组件渲染：「验证原子组件渲染是否正常。」
- 修复报错：「根据校验结果修复报错。」
- 交付文档：「输出本次 SKILL 产物的交付文档。」
- 真机：在微信开发者工具中按 Skill 指引完成真机验证。
整条链路是：先静态、再接口与渲染、有问题则修复、最后文档与真机。具体命令与检查项由 Skill 包内的 SKILL.md 及引用资源定义，本文不臆造步骤编号或配置字段。
适用场景与注意¶
适合谁
- 正在用 AI 模式产出微信小程序 SKILL、且需要可交付、可验收结果的团队或个人开发者。
- 希望在「目录规范、接口、组件、真机」之间有一致检查清单，而不是每次手写 checklist 的场景。
使用注意
- 真机环节依赖微信开发者工具，需提前准备好小程序工程与真机调试环境。
- SkillHub 页面标注
requires_api_key=false；若你使用的其他工具链仍要求密钥，以各工具文档为准。 - 社区数据（截至资料抓取）：SkillHub 评分 100000，下载 15061 次；版本以页面显示的 v0.2.3 为准，升级后行为以新版本说明为准。
结尾¶
@tencent-adm/wxa-skills-validate 把小程序 AI SKILLs 产物的静态校验、原子接口与组件验证、报错修复、交付文档和微信开发者工具真机验证串成一条工作流，适合作为 AI 生成产物之后的质量门禁。
官方 SkillHub 地址：https://www.skillhub.cn/skills/tencent-adm/wxa-skills-validate
