前言¶
做一个微信原生小程序，从头到尾要碰的东西很杂：页面结构是 WXML/WXSS，组件可能来自 TDesign MiniProgram，样式与逻辑要过微信开发者工具和 npm 构建；换了 Skyline 渲染引擎还要考虑与 WebView 的差异；接 CloudBase 就要处理云函数、登录、权限和隐私声明；只要小程序里有用户上传的头像、图片、音频或评论，就绕不开微信的内容安全接口和回调排查。把这些事拆到多个 Skill 或多次对话里，上下文很容易断，评审和验收时也不容易对齐标准。
下面介绍的 build-wechat-miniprogram 是把这些环节收拢到一个 SKILL.md 里的技能。它不做公众号排版，也不涉及小程序之外的开发，只覆盖微信原生小程序的设计、工程交付与用户内容安全审核。
这是什么¶
build-wechat-miniprogram 是一个社区来源的 Agent Skill，坐标 @user_c25e780d/build-wechat-miniprogram，当前版本 1.0.1，发布和维护者为 SkillHub 用户 user_c25e780d，分类 dev-programming。它解决的问题是：让 Agent 在一次连续的任务里完成微信原生小程序的设计、搭建、实现、评审、排查、部署和验收，而不是只回答片段性的代码问题。
官方页面标注该 Skill 不需要 API Key，属于通用 SKILL.md 格式，可用于支持该格式的 Agent 客户端。
核心功能¶
按官方简介，它的能力覆盖三块。
第一块是页面与工程。包括 WXML/WXSS 的编写、微信原生组件的使用、TDesign MiniProgram 组件接入、usingComponents 的路径与版本配置、npm 构建流程，以及微信开发者工具中的编译、预览和真机调试。
第二块是运行时与后端。包括 Skyline 与 WebView 两种渲染方式的差异处理、CloudBase 云函数调用、微信登录、权限与隐私声明的配置和排查。
第三块是用户内容安全审核。覆盖头像、图片、音频、昵称、评论等场景，涉及 security.mediaCheckAsync、security.msgSecCheck 两个接口，以及安全模式下的 HTTPS 回调配置。对于常见的 pending、审核中、回调失败、上传失败等状态，它也给出了排查方向。
此外还包括发布验证、多端适配、适老化和无障碍等交付验收事项。
安装与启用¶
官方资料未提供具体的安装命令或配置文件字段。可确认的信息如下：
- 坐标：
@user_c25e780d/build-wechat-miniprogram - 官方地址：https://api.skillhub.cn/user_c25e780d/build-wechat-miniprogram
- SkillHub 页面：https://www.skillhub.cn/skills/user_c25e780d/build-wechat-miniprogram
- 版本：1.0.1
- 是否需要 API Key：否
在支持 SkillHub 的客户端中按坐标搜索并启用即可。是否支持 Codex CLI、Cursor、Claude Code 的具体安装方式，官方资料没有说明，不做推测。
典型用法¶
官方简介以触发关键词方式说明何时启用该 Skill，实际使用时可直接用自然语言描述任务，例如：
帮我搭建一个微信原生小程序页面，用 TDesign MiniProgram 的按钮组件，
写好 WXML 和 WXSS，并配置 usingComponents。
涉及用户上传内容时，描述清楚场景和已出现的现象：
用户上传头像后一直显示 pending，mediaCheckAsync 回调失败，
帮我排查安全模式 HTTPS 回调配置。
涉及登录和数据存储时：
用 CloudBase 实现微信登录，配置云函数和权限，
并补上隐私声明。
这些示例对应的是官方列出的触发关键词范围：微信小程序、小程序搭建、小程序 UI/UX、WXML、WXSS、TDesign、构建 npm、usingComponents、Skyline、CloudBase、云函数、微信登录、权限、隐私、头像审核、内容安全、pending、审核中、回调失败、上传失败、开发者工具、真机、发布验收。
适用场景与注意¶
适合正在做微信原生小程序、且任务链条较长的开发者：从初始搭建、组件接入、构建调试，到 CloudBase 集成，再到内容安全审核和发布验收，都可以在同一个 Skill 下连续完成。
需要注意几点。
- 它只面向微信原生小程序，不覆盖 uni-app、Taro 等跨端框架，也不涉及公众号或视频号开发。
- 内容安全部分依赖微信侧的审核接口和安全模式回调，涉及域名、HTTPS 和服务器配置；回调失败时要先确认安全模式是否开启、回调地址是否可达，再检查接口调用参数。
- Skyline 与 WebView 的行为存在差异，组件和样式需要在真机上验证，不能只看开发者工具的模拟器。
- 该 Skill 为社区来源，版本 1.0.1，使用前建议对照官方文档核对接口参数和组件版本。
结尾¶
build-wechat-miniprogram 的价值在于把小程序交付中分散的工程环节和内容安全审核收进一份可触发的指令里，减少多轮对话中的上下文断裂。如果你正在做微信原生小程序，可以从这里开始：
https://api.skillhub.cn/user_c25e780d/build-wechat-miniprogram
