微信小程序避坑与协作指南

要解决的问题

微信小程序生产项目里的很多事故不在功能本身，而在审核合规、广告位、本地存储、跨项目协作这些边界处爆发：

• 页面里出现微信号、邮箱、公众号，审核被判引流；
• wx:if、hidden、广告位下沉改错，导致底部广告占屏或空白；
• “保存后重进丢失”其实是 _contentDirty / _layoutDirty 保护逻辑被破坏；
• 在他人项目上被 AI 助手擅自加功能，或把“把订阅落实”误读成“免费放开”。

技能如何工作

wechat-miniprogram-guardian 把已上线项目的维护教训拆成可执行参考：

• 从零搭建：按 greenfield-build.md 配置 app.json、本地优先存储、双广告分搭和合规入口；
• 已上线整改：按 audit-compliance.md、ad-systems.md、local-first-storage.md 定位广告、存储、审核问题；
• 协作约束：按 collaboration-rules.md 和 agent-collaboration-guardrails.md 先读代码、锁定路径、grep 复核完成状态；
• 自我升级：通过 learnings.md 记录“问题现象 + 解决思路”，不写入代码、路径、密钥或个人信息。

执行时遵循固定 SOP：先 Grep 关键字确认现状，区分可改与不可碰模块，改后做语法与关键字复核，并明确前端上传或云函数部署的生效方式。