前言¶
做微信小程序的开发者常遇到三类问题：一是刚上手时不知道工程结构怎么搭，每个页面要写哪几个文件、wxml 和 wxss 怎么配合、尺寸单位用 rpx 还是 px；二是写完之后调试阶段反复踩坑，比如 app.json 里的 disableScroll 配置非法、ctx is not defined、页面滚动卡顿；三是准备上线时搞不清 AppID 和测试号的区别、体验成员权限怎么配、上传、审核、发布这几步在哪个后台操作。这个 Skill 就是针对这三段流程给 Agent 提供一套可执行的指引。
这是什么¶
微信小程序从零到上线助手（坐标 @user_ea18365b/wb-skill-wechat-miniprogram-helper-skill）是一个基于通用 SKILL.md 格式编写的社区 Skill，发布在 SkillHub 上，由 user_ea18365b 维护。它解决的问题是：当 Agent 接到”帮我做个小程序”“小程序报错了”“小程序怎么发布”这类需求时，能按一条完整的路径走完从创建项目到提交审核上线的全过程，而不是零散地回答单个问题。
目前版本 1.0.3，分类为 dev-programming，来源标记为 community，无需 API Key 即可使用。
核心功能¶
下面介绍的覆盖范围均来自该 Skill 的官方简介。
项目搭建与架构¶
- 从零搭建小程序工程，包括目录结构和初始配置文件。
- 双线程架构：逻辑层（App Service）与渲染层（WebView）分离，这是理解所有 API 行为的基础。
- 页面四文件结构：
wxml、wxss、js、json，一个页面由这四个文件组成，职责互不替代。
开发期关键概念¶
- 尺寸单位
rpx：以 750 为屏幕宽度基准，按屏幕宽度等比缩放，替代固定 px。 setData的使用方式与常见性能误区，数据量过大时会引起渲染开销。- Canvas 2D 接口的使用方式。
常见错误定位¶
Skill 明确列出了三类高频问题的处理思路：
app.json中disableScroll配置非法导致的启动报错。- Canvas 相关代码报
ctx is not defined。 - 页面滚动或交互出现 jank（卡顿）的排查方向。
账号与权限¶
- AppID 与测试账号的区别和适用场景。
- 小程序体验成员权限的申请与配置。
发布流程¶
- 上传、提交审核、发布上线的完整工作流，对应微信公众平台后台的具体操作位置。
触发方式¶
Skill 设定的触发短语包括：微信小程序、做个小程序、小程序上线、小程序报错、小程序发布、小程序体验权限。在 Agent 对话中出现这些关键词时，该 Skill 会被激活，按上述覆盖范围组织回答。
安装与启用¶
该 Skill 基于通用 SKILL.md 格式编写，属于社区发布（community）来源，不依赖 API Key。目前官方资料中未提供可核实的具体安装命令或配置文件路径，因此这里不给出臆造的安装步骤。需要使用时，建议直接访问官方页面获取最新的启用方式。
典型用法¶
以下场景均来自该 Skill 的触发短语与功能覆盖范围。
场景一：从零创建项目¶
用户说”做个小程序”，Agent 会按四文件结构生成页面骨架，给出 app.json、页面 json 和 wxml/wxss/js 的最小可运行版本，并在生成过程中说明 rpx 的使用约定。
场景二：排查启动报错¶
用户说”小程序报错了，启动不了”，Agent 会先检查 app.json 中的 disableScroll 等全局配置项是否符合规范，再判断是否为页面级配置问题，最后定位到具体文件行号给出修改建议。
场景三：解决 Canvas 报错¶
用户说”小程序报错 ctx is not defined“，Agent 会定位到 Canvas 2D 上下文获取时机的问题——通常是在节点尚未渲染完成时就尝试获取 ctx，给出在 onReady 或节点查询回调中获取上下文的改法。
场景四：申请体验权限¶
用户说”小程序体验权限怎么开”，Agent 会说明体验成员添加入口在微信公众平台的”成员管理”—“体验成员”中，并解释需要对方微信号且对方需接受邀请。
场景五：上传与发布¶
用户说”小程序怎么发布”，Agent 会按”上传代码 → 提交审核 → 审核通过后发布”的顺序说明每一步在哪个后台页面操作，并提醒发布前确认 AppID 已通过认证、体验成员权限已配置。
适用场景与注意¶
适合以下开发者使用：
- 正在从零学习小程序开发，需要有人把工程结构和常用 API 讲清楚。
- 遇到具体报错或性能问题，需要一份常见错误的排查清单。
- 首次走发布流程，需要知道每一步操作位置。
需要注意的限制：
- 该 Skill 是社区维护（community），功能覆盖以简介中列出的范围为准，遇到超出范围的问题（如原生组件具体兼容性、云开发细节）时，需要结合其他资料补充。
- Skill 不替代微信开发者工具本身的调试能力，复杂断点调试仍需在工具内完成。
- 目前版本为 1.0.3，属于早期版本，后续更新可能调整覆盖范围。
结尾¶
微信小程序从零到上线助手的价值在于，把小程序开发中分散在文档各处的知识——工程结构、rpx、setData、Canvas 2D、典型报错、账号权限、发布流程——整合成一条 Agent 可以按序执行的路径。对于刚接触小程序的开发者和需要快速排查问题的团队，它适合作为 Agent 工具箱里的标准组件。
官方地址：https://api.skillhub.cn/user_ea18365b/wb-skill-wechat-miniprogram-helper-skill
