前言¶
做微信小程序时，难点往往不在「会不会写页面」，而在微信生态里的约束：appid 与主体资质、原生与跨端框架怎么选、云开发和自建后端如何分工、wx.login 与 session 怎么接、支付与订阅消息的接入路径，以及提审被驳回后该改哪里。通用 Web 开发的经验不能直接照搬，查官方文档又容易在多个主题之间来回跳。
下面介绍 SkillHub 上的「微信小程序开发助手」，它把上述环节收敛成可在 AI 对话里逐步推进的指导，专攻微信侧特殊性，而不是泛泛的前端教程。
这是什么¶
「微信小程序开发助手」是 SkillHub 社区来源（community）的 Agent Skill，坐标为 @user_36c7efa2/wechat-miniapp-zh，当前版本 1.0.0，分类为 dev-programming，由发布者 user_36c7efa2 维护。
官方简介将其定位为微信小程序开发的全流程助手：从 appid 申请、原生 / Taro / uni-app 选型、云开发 / 自建后端选型，到登录鉴权、支付、订阅消息、审核避坑；并强调与通用 Web 开发的区别，聚焦微信生态特殊性。页面标注 requires_api_key=false，安装使用不依赖额外 API Key。
在 SkillHub 上，该 Skill 评分 100000，累计下载 17459 次（截至页面展示数据）。
核心功能¶
依据官方简介与 SkillHub 页面说明，可核实的能力范围如下。
- 准入与选型：appid 申请相关指引；原生、Taro、uni-app 等技术路线对比与选型建议；云开发与自建后端的取舍。
- 关键业务链路：登录鉴权、微信支付、订阅消息等常见接入问题的结构化说明（具体 API 与配置以微信官方文档为准，Skill 负责在对话中对齐步骤与注意点）。
- 上线与合规：审核避坑、微信侧规则与通用 Web 差异，减少因生态特殊性导致的返工。
Skill 本体遵循通用 SKILL.md 格式，由支持 Skills 的 AI 客户端在匹配到小程序相关意图时加载，在编码与方案讨论中提供上下文化的回答。
安装与启用¶
方式一：让 AI 按 SkillHub 安装文档执行¶
SkillHub 技能页给出的提示词为：请 AI 根据 SkillHub 安装说明 安装 @user_36c7efa2/wechat-miniapp-zh。适用于 Cursor、Claude Code、Codex 等已支持 Skill 的客户端，由 Agent 读取安装文档并完成落盘。
方式二：使用 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被客户端识别。示例：
skillhub install user_36c7efa2/wechat-miniapp-zh --dir <skills 目录>
常用客户端 skills 目录（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按所用客户端要求刷新或重启，使新 Skill 生效。
典型用法¶
官方页面未附带独立代码仓库示例；典型用法是对话驱动，在已启用 Skill 的项目或全局 skills 目录下，用自然语言描述当前阶段的问题。下列表述与官方简介中的主题一致，便于触发 Skill 上下文：
- 新建项目前：说明团队栈偏好，询问「原生、Taro、uni-app 如何选型」或「云开发和自建后端怎么选」。
- 接入能力时：直接提具体目标，例如「小程序登录鉴权怎么接」「支付流程要准备哪些参数」「订阅消息模板与下发注意什么」。
- 提审前：描述类目与功能点，询问「审核容易踩的坑」或对照简介中的「审核避坑」逐项核对。
经过上面的步骤，AI 会按 Skill 内嵌的流程与微信生态约束组织回答；涉及密钥、商户号、证书等敏感信息时，仍应在本地配置与环境变量中管理，不要写入对话或仓库。
适用场景与注意¶
适合谁：正在做或准备做微信小程序的开发者、技术负责人，需要在选型、架构和关键 API 之间快速对齐，并希望在提审前减少明显违规项。
限制与注意：
- 内容来源为社区 Skill，微信官方政策与接口以 微信公众平台文档 为准；上线前务必自行核对最新规则。
- SkillHub 页面显示安装计数为 0，与下载量分开统计；是否已装入本机以你本地 skills 目录为准。
- 未要求 API Key，但不替代微信侧的真实账号、支付商户资质与服务器域名配置。
结尾¶
「微信小程序开发助手」把 appid、跨端选型、后端形态、登录支付订阅与审核避坑串成一条可对话推进的路径，适合作为微信生态专项的补充知识源。官方 Skill 页与 API 入口：
- https://www.skillhub.cn/skills/user_36c7efa2/wechat-miniapp-zh
- https://api.skillhub.cn/user_36c7efa2/wechat-miniapp-zh
