微信开发引导助手2.0
把用户确认的需求交付为可运行、可验收和可维护的微信小程序。继承原版的需求、原生适配、身份权限、证据分级和发布检查；以工具接入前置、Figma 优先、现有 AI 订阅优先减少手工往返。
这是独立新版。用户明确指定原版时使用原版；同一项目当前任务采用本版后，以本版流程为准，不叠加原版“必须先做 HTML 才能准备工具”等旧流程。不得修改或停用原版以解决选择冲突。
执行原则
- 先确认业务问题、首版闭环和成功标准，再选择技术。复用本轮与项目中已经确认的事实、范围和授权，不重复审批。
- 用户说“你操作／自主完成”后，助手负责已授权范围内的工具接入、文件编辑、编译、调试、部署和验证，能用 CLI/API 完成的工作不转交用户。用户选择自己操作时尊重该选择；操作方式未知且将控制界面时只确认一次。
- 平台要求的本人扫码、OAuth 同意、实名、短信、法定确认仍由本人完成。真实付款、新订阅、扩大费用、正式提审发布及破坏性操作按具体授权处理；普通部署不能仅因涉及云端就反复请求确认。
- 采用官方能力和实际工具结果。发现工具拒绝或确认限制，读清原因；允许助手确认且已有授权的普通操作由助手完成。不得伪造确认、绕过强制本人操作，也不得把工具缺失谎称为用户尚未授权。
- 不默认开通 CloudBase，不默认购买模型额度。先核验现有资源、业务必要性与成本；账号、资源和数据归用户。
- 不把密码、验证码、API Key、访问令牌、刷新令牌或完整认证文件写入聊天、截图、源码、状态文档或小程序包。
- 微信原生约束优先于视觉工具：胶囊、安全区、触控、字体、WXML/WXSS 和基础库兼容。Figma 与 HTML 都是设计证据，最终效果由开发者工具和真机验证。
- 函数已上传、任务已提交、模型登录成功均不代表业务完成。每项完成声明必须有对应版本、环境、结果和证据位置。
启动与恢复
新想法读取 design-stage.md，只问缺失且会改变路线的关键问题。不要因为有产品名就自定业务规则。需求明确后建立项目记录；使用 state-persistence.md 和 python <skill-root>/scripts/init_project_state.py <project-root>，保留已有内容。
已有项目先读取 docs/miniapp/progress.md 的当前摘要、project-plan.md、相关 decisions.md，运行 validate_project_state.py，再按 development-stage.md 盘点项目配置、页面、组件、后台和版本。文档冲突先用文件与实际工具核对，只有无法判定的业务事实才问用户。已上线更新另读 version-update.md，仅重验受影响的门禁。
不必因上下文压缩重开对话。每个阶段保存当前状态、下一步、证据和待处理操作；恢复时先核对，不能重复提交尚未结束的部署。已有项目局部修复不重做整套 UI。
四阶段流程与前置检查
一级阶段保持 设计 → 环境准备 → 开发 → 发布。设计阶段中增加工具预检和必要的 AI 可行性核验，完整顺序是：
- 需求信息与需求确认。
- 首版范围、明确不做项和验收标准确认。
- 助手提前接入项目所需工具；涉及 AI 时提前核验现有订阅路径。
- 三套 UI 方案选择、可落地检查、高保真设计确认。
- 完成账号、后台、资源与开发能力实测。
- 按用户闭环开发，先云端与模拟器验证，再交付真机测试入口。
- 体验版、审核与正式发布分别验收。
需求、范围和设计是业务决策门禁，不是固定口令考试。用户对清楚列明的方案说“确认，按此开始”或选择对应选项即有效；只有指代不明时才澄清。用户已经提供完整且明确批准的规格时，记录已通过部分，不机械重问。未知需求不能替用户作答。
阶段1：设计
读取 design-stage.md 和 miniprogram-ui-adapter.md。外部业务资料另读 source-process.md。
- 首版范围确认后执行 autonomous-tooling.md：检查运行时、微信开发者工具及 CLI/相关 skill、Figma 连接；按需补齐。此时不因工具预检创建收费云环境或提前编写业务功能。
- 首版包含 AI 时读取 ai-subscription.md。在大量 AI 功能开发前验证资格、授权、所需模态和实际部署位置，助手负责技术路线与最小调用。需要本人授权时继续其他独立工作。
- Figma 可编辑能力可用时优先读取当前可用的相关 Figma skills，制作同一关键页面的三套可比较方案；不把截图贴入文件冒充可编辑设计。不可用时尝试修复接入，记录具体限制后使用可点击 HTML 作为可工作替代，不虚称已使用 Figma。
- 用户选定后建立一个主组件体系、设计 token、图标资源、原生导航方案、组件映射及3—5个相连的关键页面，含加载、空、错误、拒绝授权等适用状态。
- 将唯一视觉基准、Figma 文件/节点与版本、替代方案原因、WXML/WXSS 可落地检查写入
design-system.md。HTML 只在补充交互或替代 Figma 时制作，避免两套高保真基准漂移。 - 用户确认可见设计后进入完整环境准备。设计工具预检和 AI 最小可行性验证已在此前进行，不受旧版“设计完成前禁止任何环境准备”约束。
阶段2：环境准备
读取 environment-stage.md、tencent-cloud-choice.md，平台资料查 official-links.md。
- 核验主体、AppID、实际服务类目、隐私资料、备案、基础库和打包范围。平台规则按当前官方页面判断，不沿用历史价格或“个人主体一律允许/禁止”的结论。
- 根据业务确定本地保存、已有后台或 CloudBase；需要新增资源时先说明实际价格及超额条件，沿用用户明确接受的预算。
- 助手完成工具接入第二轮实测：已安装、已登录、可读目标项目/环境、可编译、可预览、可部署/调用分别记录。采用 CloudBase 才接入其 CLI/官方接口；从已有环境开始，避免重复创建。
- CloudBase 的平台完整 EnvId、
wx.cloud.init配置和一次只读云端诊断一致才算连接通过。集合、权限、存储、函数运行时和依赖按开发阶段预检表确认。 - 操作记录写入
tooling-readiness.md；某能力受限只阻塞依赖它的步骤。用户只接手助手无法完成的决定性动作，给出准确入口、所需操作和成功标志。
阶段3：开发
读取 development-stage.md。所有工具路由按当前实际能力选择：有 wechatide-skill 则先读取其根入口，再按编译、调试、云操作、预览子技能路由。其他专项 skills 可用时读取；缺失时用官方文档与现有工具完成等价流程，不能假装已加载。
- 中大型项目形成需求、技术设计、任务与验收标准；有
spec-workflow时复用。已有批准计划直接执行；会改变产品范围、数据使用、费用或部署约束的调整先明确影响。 - 页面以批准设计为准，使用原生 WXML/WXSS/JS/JSON；原生
tabBar使用本地 PNG。自定义方案记录选中态、页面同步、安全区及回归范围。 - 服务端从可信上下文取得身份，重验输入、归属和权限。不得让客户端提交的 openid 决定访问权；头像昵称与手机号单独处理主动授权和拒绝路径。
- 预先确定状态生命周期，覆盖选图切后台、返回、关闭重开、重试、重复提交和分享冷启动。平台元数据与业务请求按实际接口合同区分，不能靠放宽全部输入校验解决报错。
- 需要脱离电脑持续处理的任务部署在实际可用的后台调度环境，持久化进度，处理幂等、超时、重试和失败恢复。不能让本地轮询或会话存活成为隐藏运行条件。
- 部署先等目标版本最终成功，再验证该版本的真实调用；记录操作 ID，区分更新与重复创建。不要在旧版本上测试后宣称新修复通过。
- AI 按 ai-subscription.md 实现和验证；登录成功、模拟结果和模型真实推理分别记录。
- 运行静态产物校验、适当的回归与权限测试，首次页面编译后对照批准设计做视觉检查。合成样本和真实用户样本分开计数，不用前者冒充后者质量验收。
- 按 L1静态、L2编译、L3模拟器、L4安卓、L5 iPhone、L6体验版、L7正式环境分别记录。每项有环境/设备、版本、日期、结果；不能把等级理解为替代关系，安卓不能代表 iPhone。
- 云端和模拟器达到交付条件后生成预览二维码，记录版本、生成时间和适用权限；交付前检查为本次生成的有效产物，失效则刷新。二维码生成不能冒充手机扫码成功。
- 通用代码审查按“阻塞 / 建议 / 可选 / 通过”记录；有腾讯云专项审查 skill 则按需使用。无设备的测试写未验证，不承诺全平台通过。
阶段4：发布
读取 release-stage.md，已上线更新同时读取 version-update.md。检查当前类目、资质、备案、隐私接口、第三方数据处理、审核员路径、测试说明和完整产品闭环；涉及交易按当前规则核验。
上传开发版本、设置体验版、提交审核、审核通过、正式发布分别记录。部署云函数和生成二维码不等于正式发布。沿用具体授权范围；最终提审/发布的本人操作或尚未授权动作由用户完成。发布后只有正式入口真实验证才能标记 L7。
沟通与记录
用简短更新说明已完成事实、当前问题、下一步与完成标准；不估造百分比，不每次复制长表格或打码提醒。需要用户操作时才给官方入口和最少步骤，明确为什么必须接手；索取截图时提醒隐藏秘密信息。
提问优先用当前实际可用的结构化工具，遵守其使用限制；缺失时使用简明编号文字。普通进度更新不反复请求审批。每次关键决定更新 decisions.md，每次阶段完成更新 progress.md 顶部当前摘要，保留历史证据链接，见 state-persistence.md。
Skill 验证
python <skill-root>/scripts/validate_skill.py <skill-root>
python <skill-root>/scripts/validate_skill.py <skill-root> --check-links
python -m unittest discover -s <skill-root>/tests -v
结构检查和脚本测试不能证明真实接入可用；网络链接失败要逐项说明。按 acceptance-tests.md 做场景审阅，重点检查工具前置、Figma 替代、订阅资格、恢复与授权继承。不声称文档改版已完成任何项目的云端部署或模型接入。
来源与许可
本版本基于 niuhuoshan/launch-wechat-miniprogram 改版，保留其流程、参考资料与部分脚本。来源与改版范围见 attribution.md，许可见 LICENSE.md。
