小程序开发工程技能套件

中文 · 繁體中文 · English · 日本語 · ไทย · Bahasa Indonesia

小程序开发工程技能套件 是一套面向 Agent 的技能套件，专为小程序从 0 到 1 开发、已有项目接管和上线前治理设计。它把「先弄清楚要做什么、怎么做、做到哪一步、有没有证据」这条链路拆成可执行的工程流程，帮助不熟悉小程序开发的人在 Agent 辅助下少踩坑、少返工、不越权。

英文名：Mini Program Engineering Skill Suite。

3.5.0 把恢复与保存边界说得更清楚：不猜历史来源、不丢原归属，保留产品允许的草稿和空目录；同一轮、内容未变的完成与返回共享一次保存，迟到结果不覆盖新编辑。前台结束等待时保留未核实的业务状态，跨重进恢复须验证持久确认与重建读取。质量优先，也要求及时交付可验收成果，用短反馈说明结果和下一步，减少重复确认与无变化复测。

---

核心亮点

• 三平台事实层：微信 / 支付宝 / 抖音的平台规则单一事实源，capability doctor 自动识别项目技术栈与目标平台；检测能力如实分级——微信支持确定性指纹监测，支付宝 / 抖音依赖执行时查官方与用户上报，不假装能自动检测（见平台规则保鲜）。
• 平台规则保鲜流水线：执行层即时对齐官方现行文档，内容层每周检测漂移；仅审核一致的 facts.md 更新自动提 PR，CI 通过后自动合并，其余结果留在 issue（见平台规则保鲜）。
• 真实 Agent CLI 与产物级验证：tier1 是本地静态检查；tier2/3 和独立模型判定使用真实 Agent 会话，行为版本另需 tier4 匿名项目配对门禁。3.5.0 使用 ZCode / GLM-5.3 + GLM-5.3-Flash；支持可插拔引擎不代表每个引擎均已实测，具体范围见 EVALUATIONS.md。
• 日常操作边界更完整：引导 Agent 检查返回刷新、弹窗关闭重开、连续输入与自动保存、云端失败恢复，防止旧状态干扰新操作；实际效果须在目标项目验证。
• 质量优先、进度可见：推进主链路并交付可查看成果，按新改动、真实失败或证据缺口补测，及时交接用户选定的人工操作，减少重复确认与配合负担。
• 证据优先工程纪律：状态必须由匹配证据支撑，没有证据就如实标注 unknown；3.0 起这套纪律沉淀为领域无关的基础技能层 foundation/，可被任何 Agent 工程套件复用（见设计原则）。
• 分层评测 + 独立签署：tier1 结构 / tier2 路由 / tier3 行为 / tier4 匿名合成项目产物非退化，配合 with-skill 与 baseline 独立判定及冻结 held-out 批，门禁全 PASS 才发布（见 EVALUATIONS.md）。
• 供应链级发布治理：SHA256 + 双 manifest + fail-closed 出包 + 接收端复验 + 敏感信息扫描清零，六语言 README 结构一致性由脚本守护（见包完整性）。

---

32 秒看懂这套技能

如果你想先快速了解这套 Skill 解决什么问题、从哪里沉淀出来、适合怎么用，可以先看这个 32 秒说明视频。

https://github.com/user-attachments/assets/d382951e-5175-48be-b0c0-44ba210706f1

视频仅用于说明这套 Skill 的定位、来源和使用边界。

---

项目状态

本仓库是这套套件的公开项目主页，已通过 MIT License 开源发布。任何人都可以查看、使用、修改和再分发，具体条款见 LICENSE。

---

它解决了什么问题

做小程序这件事，对没接触过的人来说远比看上去复杂。真正难的往往不是写某一段代码，而是从一开始就不知道该先确认什么、哪些决策会影响后面、什么时候该停下来验证，以及上线前哪些事不能凭感觉跳过。

工具链分散、平台规则琐碎、上线审核环环相扣。无论你是第一次做小程序的产品经理 / 创业者，还是临时接手老项目的开发者，往往会在这些地方反复踩坑：

• 环境装到一半报错、配置前后不一致；
• 上线之后才发现权限漏配，临时补隐私协议；
• UI 在不同机型上严重错位，真机表现和模拟器完全两个样子；
• 提审版本和发布版本混淆，误把没验收的代码送审；
• 误操作把没确认的改动推到了线上，要紧急回滚……

小程序开发工程技能套件 把这些容易踩坑的环节打包成 Agent 可以直接执行的工程能力：先梳理目标和边界，再形成产品规格和工程方案，然后小步实现、分层验证、收口发布风险。它不替你做商业和产品决定，但能让一个不懂小程序开发的人在 Agent 的辅助下走完从 0 到 1 的关键路径，知道下一步该做什么、为什么做、做到什么程度才算有证据。

---

真实项目来源：语宠精灵

这套 Skill 不是从抽象教程里写出来的，而是从真实微信小程序「语宠精灵」的长期开发协作中提炼出来的。它沉淀的是小程序从 0 到 1 的产品拆解、工程实施、验证验收、发布准备和证据管理方法。

「语宠精灵」仅作为真实来源案例展示。本仓库只公开可复用的小程序开发工程方法，不包含该小程序源码、AppID、云资源、私有配置、业务数据、审核状态或内部开发记录。小程序二维码仅用于体验真实案例，扫码结果以微信平台当前状态为准。

---

它帮助 Agent 做到这些事

• 接手项目：先摸清现有的项目状态再动手改，避免破坏已有功能；
• 澄清需求：把模糊的产品想法转成可以验收的明确规格；
• 沉淀决策：把已经定了的产品决策落到架构、数据、接口、权限和兜底逻辑上；
• 安全改代码：在保留原有成果的前提下，做小颗粒、可回滚的改动；
• 逐级验证：把 UI 预览、用户确认、集成验证、机型适配、最终验收当成互相不等价的环节；
• 用证据排错：依据真实证据定位问题，而不是凭感觉猜；
• 如实汇报：老老实实报告当前验证到了哪一步，不夸大也不省略；
• 平台规则保鲜：执行发布、提审、隐私申报等平台触点步骤时，按官方现行规则执行，不被套件内置的旧规则带偏（见下文「平台规则保鲜」）。

---

平台规则保鲜

平台规则会持续变化，任何写死在技能里的规则都会过期。这套套件从 2.0 起采用「执行层即时保鲜，内容层受控进化」：