前言¶
微信小程序和通用 Web 前端不是同一套约束：包体要卡在分包与 2MB 规则里，登录与支付要走微信开放能力，云开发、订阅消息、内容安全各有独立文档。平时靠搜索引擎拼片段，容易踩到已废弃的 API，或在分包、鉴权细节上反复试错。
下面介绍 SkillHub 上的 Wechat Miniprogram Toolkit。它把初始化、云开发、支付、分包分析等能力收进标准 SKILL.md 与 references/ 文档，让 Coding Agent 按任务加载对应章节，而不是每次从零检索官方文档。
这是什么¶
Wechat Miniprogram Toolkit（包名 wechat-miniprogram-toolkit，当前公开元数据版本 1.6.0，MIT 许可证）是面向微信小程序的 Agent Skill。SkillHub 分类为 dev-programming，社区评分 93834，累计下载 1574 次（截至任务线索中的平台统计）。
发布路径为 @user_64e5b706/wechat-miniprogram-toolkit。Skill 自述整合腾讯云侧常见实践、Skyline Worklet 规范与 CI/CD 参考，目标是从项目初始化到上线发布的一站式指引；框架级细节仍以微信开放文档为准。
官方入口：
- API 地址：https://api.skillhub.cn/user_64e5b706/wechat-miniprogram-toolkit
- 社区页面：https://www.skillhub.cn/skills/user_64e5b706/wechat-miniprogram-toolkit
核心功能¶
Skill 入口 SKILL.md 与分主题 references/*.md 覆盖下列模块（按官方描述整理）：
- 工程与规范：项目目录、
project.config.json、app.json初始化（project-init.md）。 - 云开发：数据库、存储、云函数，含聚合查询与事务（
cloud-dev.md）。 - 登录鉴权：openid / UnionID、手机号等（
auth.md）。 - 微信支付：JSAPI、统一下单、支付通知、退款（
payment.md）。 - 直播与实时音视频：live 组件与 TRTC 相关指引（
live-stream.md）。 - 数据与增长：数据分析、埋点（
analytics.md）；分享、海报、朋友圈（share.md）。 - TypeScript：类型与泛型封装（
typescript.md）。 - 云托管：容器化后端（
cloudhosting.md）。 - 消息：客服消息、订阅消息（
messaging.md）。 - 合规与跳转：内容安全审核（
content-safety.md）；APP 与小程序互跳、URL Scheme（miniapp-handoff.md）。 - 端能力：蓝牙、GPS、NFC、Wi-Fi、扫码等（
hardware.md）。 - 性能与渲染：分包策略（
subpackage.md）；Skyline / Worklet（advanced-render.md）；WXS 与性能（wxs-performance.md）。 - 工程化：CI/CD（
ci-cd.md）；Python 脚本scripts/analyze_subpackages.py做分包分析；references/error-log.md记录错误与进化。
Skill 声明适用基础库：≥ 2.2.3（云开发）、≥ 3.0（Skyline）。明确不适用的场景包括：Web 端微信登录（需其他 skill）、非微信系小程序、以及强依赖非云开发商户后台直连且未覆盖的服务端形态。
安装与启用¶
先做安装，再在对话里用自然语言触发 Skill 内文档。公开资料给出两种安装方式，按你使用的工具链选择其一。
方式一：SkillHub CLI（Skill 快速上手中的写法）
skillhub install wechat-miniprogram-toolkit
未安装 CLI 时，Skill 说明可让 Agent 协助完成 SkillHub 环境准备。
方式二：secure-skills-cli（360 安全技能中心等镜像页列出的同款包）
npx secure-skills-cli add wechat-miniprogram-toolkit
安装完成后，Agent 应读取 Skill 根目录的 SKILL.md，并按「写代码前先读」表加载对应 references/ 文件。Cursor、Codex CLI、Claude Code 等客户端若已支持 Skill 目录或 SkillHub 集成，行为一致：以本地 Skill 包为准，无需额外配置文件（公开材料未给出各客户端差异说明时，不单独臆造路径）。
典型用法¶
经过上面的安装步骤，可以按下面几类任务复现官方示例。
1. 从零初始化项目
对 Agent 说明需求，例如：「帮我创建一个微信小程序项目，包含云开发、分包、登录功能」。Agent 应参照 references/project-init.md 生成目录与配置。
2. 上线前分包分析
在项目根目录准备好页面与资源后，让 Agent 运行分包脚本。命令形如：
python scripts/analyze_subpackages.py <项目目录> --main-max 2 --pkg-max 2
脚本会输出可并入 app.json 的分包配置片段。
3. 云开发 CRUD（片段示例）
Skill 文档中的数据库读写模式如下，Agent 生成业务代码时可对照：
const db = wx.cloud.database()
await db.collection('posts').add({ data: { title: '标题', _openid, createdAt: db.serverDate() } })
await db.collection('posts').where({ _openid: wx.getStorageSync('openid') }).get()
await db.collection('posts').doc(id).update({ data: { title: '新标题' } })
await db.collection('posts').doc(id).remove()
4. 登录与云函数鉴权
小程序端初始化云环境；openid 在云函数内通过上下文获取，避免前后端来回传递：
wx.cloud.init({ env: 'your-env-id', traceUser: true })
// 云函数内：const openid = cloud.getWXContext().OPENID
5. 可选：GitHub Actions 发布
对 Agent 说：「配置 GitHub Actions 自动发布」，应参照 references/ci-cd.md。项目侧如需上传审核，文档列出可选依赖 miniprogram-ci：
npm install miniprogram-ci -D
遇到报错时，Skill 建议先查「常见错误处理」表，再读对应 reference 的 Common Mistakes，或让 Agent「查看这个 skill 的错误台账」。
适用场景与注意¶
适合谁
- 已在用 Coding Agent 写微信小程序，希望减少翻文档、废弃 API 和分包踩坑的开发者。
- 需要云开发、支付、订阅消息、内容安全等「多条线并行」的中大型小程序，希望 Agent 按模块引用统一范本。
使用前准备（Skill 列出的平台侧事项）
- 微信开发者工具、小程序 AppID、云开发环境；支付场景需商户号；CI/CD 场景可选 GitHub 仓库与
miniprogram-ci。 - 账号注册与实名认证需本人在微信公众平台完成，Skill 只能覆盖代码与配置层。
限制与坑
- 不要把 Web 登录页照搬到小程序；头像昵称应使用
chooseAvatar与type="nickname"，勿依赖已废弃的getUserInfo/getUserProfile。 - 云函数内环境 ID 宜用
cloud.DYNAMIC_CURRENT_ENV；小程序端wx.cloud.init需使用字符串环境 ID。 - 分包之间不要直接
require跨包组件，可用云函数或 eventBus 解耦。 - Skill 自述的「自我进化」会写入
error-log.md；团队若 fork 或二次分发，需自行评审变更。
结尾¶
Wechat Miniprogram Toolkit 把微信小程序高频能力拆成可检索的 reference，并附带分包分析脚本与错误台账，适合作为 Agent 侧的长期开发手册。若你要在 SkillHub 查看详情或安装，可打开：https://api.skillhub.cn/user_64e5b706/wechat-miniprogram-toolkit
