English | 中文

小程序开发工程技能套件

小程序开发工程技能套件 是一套面向 Agent 的技能套件，专为以「看得见的证据」为依据的小程序开发设计。它把从接手一个陌生项目，到把模糊想法变成可验证的产品规格，再到做出 MVP、调通真机、过审上线 —— 这一整条零碎、又容易踩坑的链路，沉淀成 Agent 可以直接执行的能力。

英文名：Mini Program Engineering Skill Suite。

项目状态

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

它解决了什么问题

做小程序这件事，对没接触过的人来说远比看上去复杂。

工具链分散、平台规则琐碎、上线审核环环相扣。无论你是第一次做小程序的产品经理 / 创业者，还是临时接手老项目的开发者，往往要在「摸清现状、写清需求、做出 MVP、过审上线」这四件事上反复踩坑：

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

小程序开发工程技能套件 把这些容易踩坑的环节打包成 Agent 可以直接执行的工程能力 —— 从接手一个陌生项目，到把模糊想法变成可验证的规格，再到控制变更范围、保证真机表现、守住上线每一步的「看得见的证据」。它不替你做开发决定，但能让一个不懂小程序开发的人在 Agent 的辅助下走完从 0 到 1 的全程，少踩坑、少返工、不越权。

它帮助 Agent 做到这些事

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

能力清单

设计原则

• 事实先于动作：没摸清现状，别动项目。
• 证据对齐状态：报什么状态，就得有什么状态被真实验证过。
• 环节边界明确：预览、实现、构建、上传、审核、验收、上线、回滚 —— 这些环节互相不可替代。
• 外部动作独立授权：上传、提交审核、发布、云端改动、仓库公开放开等外部写动作，分别独立授权。
• 私有信息隔离：对外分发的包，必须先过脱敏和敏感信息检查。
• 真机才是真相：本地检查、静态检查、模拟器都不能替代真机、体验版、生产环境的真实证据。

适用场景

这套套件适合在以下场景里辅助 Agent 完成小程序工程任务 —— 尤其是当项目已经累积了产品决策、UI 约定、平台约束和发布风险之后。

典型的使用场景包括：

• 接手一个陌生的小程序仓库；
• 从零开始规划一个新小程序；
• 在不破坏已有验收成果的前提下实现一个新功能；
• 检查项目当前是否到了可以上传、提审或发布的状态；
• 把反复出现的工程判断沉淀成可复用的 Agent 行为。

它不会做什么

这套套件不会自动安装项目依赖、创建云端资源、上传包、提交审核、发布版本，或改动线上状态。它可以准备好证据和操作指引，但每个外部动作都仍需独立授权。

验证

当前套件版本在冻结前会经过：结构校验、敏感信息扫描、对公包导出的确定性检查、清单核对、路由评估、行为评估和独立终审。

接收一个包时，通过它的 package-manifest.json 校验完整性；源码工作副本在分发前会先经过校验和敏感扫描。

包完整性

请使用 可信来源 提供的发布包，不要混用不同版本的文件。VERSION 是版本号的唯一权威。一个包如果包含 package-manifest.json，可以通过重新计算每个文件的大小和 SHA-256 摘要来校验：

python3 <包目录>/scripts/verify_public_package.py <包目录>

这条命令只确认包本身的完整性，不证明发布者身份、平台审核结果或生产发布状态。请保留上一个已校验过的包及其清单摘要，以便后续版本回退。

当前版本

当前工作版本：1.1.0。

许可证

本项目采用 MIT License 开源发布，详见 LICENSE。你可以自由使用、修改、分发和商用本项目，但需保留版权声明与许可说明。