Skip to content
Back to search

mini-program-engineering-suite

Orchestrate evidence-first engineering for WeChat and other mini programs from a vague idea or existing repository through project discovery, product specification, architecture, implementation, debugging, device adaptation, verification, and release readiness. Use when users ask to build a mini program from zero to one, take over an existing mini-program project, deliver a cross-stage feature, diagnose project status, coordinate development and testing, or judge whether a mini program is ready to upload or release. Enforces fact discovery, change boundaries, stage gates, evidence-calibrated status, sensitive-information redaction, and continuity after side questions.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nocodemrli--mini-program-engineering-skill-suite/badge.svg)](/listings/nocodemrli--mini-program-engineering-skill-suite)

HTML

<a href="/listings/nocodemrli--mini-program-engineering-skill-suite"><img src="/api/listings/nocodemrli--mini-program-engineering-skill-suite/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 140 lines
  1. ---
  2. name: mini-program-engineering-suite
  3. description: >-
  4. Orchestrate evidence-first engineering for WeChat and other mini programs from a vague idea or existing repository through project discovery, product specification, architecture, implementation, debugging, device adaptation, verification, and release readiness. Use when users ask to build a mini program from zero to one, take over an existing mini-program project, deliver a cross-stage feature, diagnose project status, coordinate development and testing, or judge whether a mini program is ready to upload or release. Enforces fact discovery, change boundaries, stage gates, evidence-calibrated status, sensitive-information redaction, and continuity after side questions.
  5. license: MIT
  6. compatibility: Requires Python 3.9+ for bundled scripts; framework adapters are optional and discovered read-only.
  7. metadata:
  8. version: "3.7.0"
  9. author: "Mini Program Engineering Suite contributors"
  10. maintainers: "Mini Program Engineering Suite contributors"
  11. language: "zh-CN"
  12. created: "2026-08-12"
  13. last_reviewed: "2026-11-11"
  14. review_interval_days: "90"
  15. ---
  16. # /mini-program-engineering-suite — 小程序工程开发套件
  17. 把小程序任务视为一条有阶段、有门禁、有证据的工程链路。先确认当前事实,再决定路由和动作;只把已经有证据支持的状态报告给用户。
  18. ## 启动顺序
  19. 1. 读取当前项目及上级目录中的 `AGENTS.md`、`CLAUDE.md` 或同类规则文件。
  20. 2. 读取 [共享工程门禁](shared/engineering-guardrails.md)、[证据状态模型](shared/evidence-status-model.md)、[判断与确认规则](shared/decision-and-confirmation-rules.md) 和 [脱敏规则](shared/redaction-policy.md),再按当前阶段读取对应分 Skill 及其引用合同。未知技术栈可运行只读 `scripts/capability_doctor.py`;涉及对外输出时读取 [文档边界](shared/documentation-boundaries.md)。
  21. 3. 判断这是新项目、已有项目,还是没有项目目录的咨询任务。
  22. 4. 已有项目开发若无本轮事实图,先用 [项目接管 Skill](skills/mini-program-project-intake-skill/SKILL.md);纯只读审计走 [源码审计短路径](skills/mini-program-verification-skill/references/source-audit-workflow.md)。只读发现前不改代码。
  23. 5. 建立或恢复任务计划,记录原目标、当前阶段、完成证据和未完成项。
  24. ## 判断当前阶段
  25. 使用 [路由与状态机](references/routing-and-state-machine.md) 判断当前阶段。允许跳过与任务无关的阶段,但必须说明依据;不能因为已经写了代码就跳过验证。
  26. | 用户意图 | 当前路由 | 可用状态 |
  27. | --- | --- | --- |
  28. | 接管项目、了解现状、识别技术栈或改动边界 | [`mini-program-project-intake-skill`](skills/mini-program-project-intake-skill/SKILL.md) | 已实现 |
  29. | 梳理产品、MVP、流程与状态 | [`mini-program-product-spec-skill`](skills/mini-program-product-spec-skill/SKILL.md) | 已实现 |
  30. | 设计模块、数据、接口与权限 | [`mini-program-architecture-skill`](skills/mini-program-architecture-skill/SKILL.md) | 已实现 |
  31. | 微信平台规则、工具、隐私与配置 | [`wechat-mini-program-platform-skill`](skills/wechat-mini-program-platform-skill/SKILL.md) | 已实现 |
  32. | 编写或修改代码 | [`mini-program-implementation-skill`](skills/mini-program-implementation-skill/SKILL.md) | 已实现 |
  33. | UI、参考还原、机型适配与手势 | [`mini-program-ui-device-skill`](skills/mini-program-ui-device-skill/SKILL.md) | 已实现 |
  34. | 白屏、错误、卡顿或状态异常 | [`mini-program-debugging-skill`](skills/mini-program-debugging-skill/SKILL.md) | 已实现 |
  35. | 独立测试、回归或交付证据判断 | [`mini-program-verification-skill`](skills/mini-program-verification-skill/SKILL.md) | 已实现 |
  36. | 版本、导出、上传/审核/发布就绪治理 | [`mini-program-release-skill`](skills/mini-program-release-skill/SKILL.md) | 已实现 |
  37. 组件缺失时报告能力边界,仅做安全只读发现与拆解,不伪称调用。已实现组件可编排或独立使用,只交换阶段产物,不互调脚本。
  38. ## 编排工程任务
  39. ### 新项目从 0 到 1
  40. 按 `discovery → specification → architecture → implementation → verification → release-ready` 推进。先澄清核心用户、问题和最小闭环,再选择技术方案。没有用户授权时,不提交审核、不发布、不创建付费资源。
  41. ### 已有项目开发或修复
  42. 先执行项目接管,获得事实图、风险、未知项和改动边界。只在范围明确后实施;对错误先复现并定位根因,对共享契约补相应验证。
  43. ### 发布前判断
  44. 分别核对源码、当前分支、构建产物、开发者工具加载版本、平台上传记录与正式环境证据。任一层缺少证据时,只报告到已经证明的状态。
  45. ## 执行门禁
  46. - 未读取事实源,不修改已有项目。
  47. - 未确认产品语义,不新增按钮、入口、状态、付费、广告或数据规则。
  48. - 高影响视觉方案先给预览或候选方案,用户确认后再集成。
  49. - 数据、权限、外部服务和不可逆操作先说明影响、失败策略与回滚条件。
  50. - 工具异常、超时或中止后的在途动作先保持 `unknown`,刷新本地与外部事实,不盲目重放写操作。
  51. - 资产变体与证据材料分别记录谱系、指纹、适用范围和不能证明的内容。
  52. - 已实现必须进入与风险匹配的验证;本地通过不能推导出真机、云端或发布通过。
  53. - 质量优先;按[推进与反馈合同](skills/mini-program-project-intake-skill/references/intake-workflow.md)交付每批可验收增量,及时接入主入口、限定隔离,复用有效检查;内部测试数量不代表用户进度。
  54. - 对外输出和安装包运行 `python3 scripts/scan_sensitive_content.py <path> --format json`。
  55. ## 中途问题与连续执行
  56. 用户提出中途问题时,先回答问题,再判断它是否改变原目标。若没有改变,恢复原计划与未完成步骤;若改变,更新计划并说明受影响阶段。不得把中途问题当成默默终止原任务的理由。
  57. ## 输出契约
  58. 阶段性或最终汇报至少包含:
  59. 1. 当前结论与工程阶段。
  60. 2. 已完成的动作及对应证据。
  61. 3. 未执行、未验证或待用户确认的内容。
  62. 4. 当前改动边界与残余风险。
  63. 5. 下一步动作。
  64. 使用 [证据状态模型](shared/evidence-status-model.md) 中的状态词。用户明确验收前,不使用 `accepted`(已正式验收);没有平台正式证据时,不使用 `released`(已正式发布)。
  65. ## 能力地图
  66. - 基础层(3.0 新增,领域无关,可独立分发):[evidence-first-engineering](foundation/SKILL.md) —— 证据状态模型、工程门禁、判断与确认规则、脱敏规则与四个交付模板的通用版本,位于 `foundation/`;本套件是其第一个垂直应用,`scripts/check_foundation_equivalence.py` 保证通用版与 shared/ 原版不分叉。
  67. - [项目接管 Skill](skills/mini-program-project-intake-skill/SKILL.md):只读建立项目事实图、技术栈、风险、未知项和改动边界。
  68. - [产品规格 Skill](skills/mini-program-product-spec-skill/SKILL.md):将模糊想法收敛为范围、流程、状态矩阵与可测试验收标准,不发明产品逻辑。
  69. - [工程架构 Skill](skills/mini-program-architecture-skill/SKILL.md):把稳定产品语义映射为模块、状态源、数据、接口、权限、失败策略与 ADR。
  70. - [微信平台适配 Skill](skills/wechat-mini-program-platform-skill/SKILL.md):只读核对工具、构建、权限、隐私和发布证据层;时效性规则查微信官方当前资料。
  71. - 平台事实层(按目标平台路由,doctor 的 `target_platforms` 决定入口):
  72. - 微信:[platforms/wechat/](platforms/wechat/platform-evidence-layers.md)(证据层、核对清单、隐私矩阵、[规则地图](platforms/wechat/rule-map.json) 与 [核验标注](platforms/wechat/facts.md);支持确定性漂移检测);
  73. - 支付宝:[规则地图](platforms/alipay/rule-map.json) 与 [核验标注](platforms/alipay/facts.md)(官方文档为客户端渲染 SPA,确定性指纹不可观测,保鲜依赖运行时查官方与用户上报,规则地图标 `manual-only`);
  74. - 抖音:[规则地图](platforms/douyin/rule-map.json) 与 [核验标注](platforms/douyin/facts.md)(官方文档为客户端渲染同构壳页,确定性指纹不可观测文章内容,同样标 `manual-only`);
  75. - 未收录平台:无平台事实层,平台触点步骤一律查官方当前资料并保持 `unknown`,不猜测。
  76. - 工程流程层遇到平台触点时引用对应平台事实层,不内置平台规则;事实标注规范、检测模式与「运行时只读 / 刷新走 PR」的基线治理边界见 [platforms/README.md](platforms/README.md)。
  77. - [工程实现 Skill](skills/mini-program-implementation-skill/SKILL.md):在明确边界内保护用户改动,以测试驱动小步实施并交付验证入口。
  78. - [界面与真机适配 Skill](skills/mini-program-ui-device-skill/SKILL.md):按参考目标处理预览、确认、集成、屏幕/内容边界、手势和真机证据。
  79. - [问题调试 Skill](skills/mini-program-debugging-skill/SKILL.md):从最小复现、竞争假设与判别实验定位根因,并覆盖同类状态回归。
  80. - [工程验证 Skill](skills/mini-program-verification-skill/SKILL.md):按风险分层执行静态、单元、集成、状态、真机、云端和发布验证,报告已执行、未执行与残余风险。
  81. - [发布治理 Skill](skills/mini-program-release-skill/SKILL.md):核对版本、构建、安全、权限隐私、回滚和各发布层证据;默认只读,外部动作逐项授权。
  82. 组件含 `agents/openai.yaml`、工作流与模板,可独立安装触发;主 Skill 统一编排、计划与证据状态。
  83. ## 共享模板与门禁
  84. - [项目接管模板](shared/templates/project-intake.md):统一接管输出。
  85. - [实施计划模板](shared/templates/implementation-plan.md):记录范围、步骤与门禁。
  86. - [验证报告模板](shared/templates/verification-report.md):区分检查范围与证据层级。
  87. - [发布清单模板](shared/templates/release-checklist.md):核对发布链路,但不授权外部操作。
  88. - [共享工程门禁](shared/engineering-guardrails.md)、[证据状态模型](shared/evidence-status-model.md)、[判断与确认规则](shared/decision-and-confirmation-rules.md)、[脱敏规则](shared/redaction-policy.md) 和 [公开与内部文档边界](shared/documentation-boundaries.md):统一约束所有组件。
  89. ## 维护脚本与公开包
  90. - `VERSION`:套件语义版本事实源。
  91. - `scripts/validate_suite.py`:检查主 Skill、九个分 Skill、共享层、公开文档、版本事实源、链接、frontmatter、界面元数据和占位内容。
  92. - `scripts/check_i18n_readme_structure.py`:检查六种语言 README 的核心章节顺序,防止安装、验证、包完整性、版本和许可说明漂移。
  93. - `scripts/scan_sensitive_content.py`:扫描公开包候选中的真实 AppID、云环境 ID、凭证形态、用户路径、邮箱、手机号、JWT、COS bucket、私钥块与二进制命中。
  94. - `scripts/export_public_package.py`:按明确公共路径清单执行全候选敏感扫描和确定性导出,未知文件默认拒绝,并生成相对路径哈希清单。
  95. - `scripts/verify_public_package.py`:只读取收到的公共包,独立复算文件大小与 SHA-256,并拒绝缺失、篡改、新增、非法路径或损坏清单。
  96. - `scripts/summarize_evaluations.py`:把发布门禁的评测产物汇总为只含结论、关键指标与审计元数据的公开摘要,不含提示词、回复或夹具内容。
  97. - `scripts/artifact_nondegradation_gate.py`:fail-closed 复验私有 Tier 4 配对产物证据。
  98. - [评测证据说明](EVALUATIONS.md):说明 tier1-4、独立判定、签署和公开摘要边界。
  99. - `scripts/capability_doctor.py`:只读识别原生/Taro/uni-app、既有脚本、测试依赖、分包和工具事实;不执行命令、不安装依赖、不输出配置值。
  100. - `scripts/audit_source_inventory.py`:只读生成文件清单、数量和指纹;匿名快照无 Git 时不借外层提交,拦截不实报告。
  101. - `install.sh`:从源码或已导出的公开包中安装套件,默认不覆盖已有目录,项目级安装必须显式传入目标项目路径。
  102. - `.github/workflows/ci.yml` 与 `.github/workflows/release.yml`:分别守住常规变更门禁和版本化发布包门禁;Release 附带压缩包、`package-manifest.json` 与 `SHA256SUMS`。
  103. ## 可靠性方法论资源
  104. - [中断恢复协议](skills/mini-program-debugging-skill/references/interruption-recovery-protocol.md):中断后把在途动作保持为 `unknown`,刷新事实并阻止盲目重放。
  105. - [资产谱系记录](skills/mini-program-ui-device-skill/assets/asset-lineage-record.md):追踪原始/衍生资产、处理、目标槽位、文件指纹、批准和替换关系。
  106. - [证据可采信规则](skills/mini-program-verification-skill/references/evidence-admissibility.md):判断证据来源、版本、完整性、适用结论和不能证明的内容。
  107. - [质量证据矩阵](skills/mini-program-verification-skill/assets/quality-evidence-matrix.md):记录包体/分包、启动/首屏、运行错误和发布后观察窗。
  108. - 增强合同:[重定位与转向](skills/mini-program-project-intake-skill/references/relocation-and-pivot-audit.md)、[观测、身份与确认写入](skills/mini-program-architecture-skill/references/cloud-state-and-write-contracts.md)、[云资产交付](skills/mini-program-implementation-skill/references/cloud-asset-delivery-workflow.md)、[运行时状态与布局](skills/mini-program-ui-device-skill/references/runtime-state-and-layout-contracts.md)、[分维度质量](skills/mini-program-verification-skill/references/dimensional-quality-contract.md)、[云发布与运维](skills/mini-program-release-skill/references/cloud-release-operations.md)。
README.md · README · 356 lines
  1. <p align="center">
  2. <img src="assets/readme-cover.webp?v=3.7.0" alt="小程序开发工程技能套件 封面" width="100%">
  3. </p>
  4. # 小程序开发工程技能套件
  5. <p align="center">
  6. <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT">
  7. <img src="https://github.com/NocodeMrLi/mini-program-engineering-skill-suite/actions/workflows/ci.yml/badge.svg" alt="CI">
  8. <img src="https://img.shields.io/badge/platform-WeChat%20%7C%20Alipay%20%7C%20Douyin-07C160.svg" alt="Platform: WeChat | Alipay | Douyin">
  9. <img src="https://img.shields.io/badge/type-Agent%20Skill%20Suite-7B61FF.svg" alt="Type: Agent Skill Suite">
  10. <img src="https://img.shields.io/badge/category-Evidence--First%20Engineering-FF6B35.svg" alt="Category: Evidence-First Engineering">
  11. <img src="https://img.shields.io/badge/stack-Taro%20%7C%20uni--app%20%7C%20native-4CAF50.svg" alt="Stack: Taro / uni-app / native">
  12. <img src="https://img.shields.io/badge/runtime-Python%203.9%2B-3776AB.svg" alt="Runtime: Python 3.9+">
  13. <img src="https://img.shields.io/badge/lang-中文-EA580C.svg" alt="Language: 中文">
  14. <img src="https://img.shields.io/badge/status-Active%20Development-22C55E.svg" alt="Status: Active Development">
  15. <img src="https://img.shields.io/badge/version-3.7.0-0EA5E9.svg" alt="Version: 3.7.0">
  16. </p>
  17. <p align="center">
  18. <a href="./README.md">中文</a> ·
  19. <a href="./README.zh-Hant.md">繁體中文</a> ·
  20. <a href="./README.en.md">English</a> ·
  21. <a href="./README.ja.md">日本語</a> ·
  22. <a href="./README.th.md">ไทย</a> ·
  23. <a href="./README.id.md">Bahasa Indonesia</a>
  24. </p>
  25. **小程序开发工程技能套件** 是一套面向 Agent 的技能套件,专为小程序从 0 到 1 开发、已有项目接管和上线前治理设计。它把「先弄清楚要做什么、怎么做、做到哪一步、有没有证据」这条链路拆成可执行的工程流程,帮助不熟悉小程序开发的人在 Agent 辅助下少踩坑、少返工、不越权。
  26. 英文名:**Mini Program Engineering Skill Suite**。
  27. 3.6.0 重点补强三件事:数据不一致时分清更新时间差与真实异常;核对状态时同时确认身份、环境和完整范围;删除、清理等操作让预览、确认与实际执行保持一致。沿用已有产品流程,失败保留输入,未知结果先查证,减少用户重复操作和无变化复测。
  28. 3.7.0 补强两条既有工作流:[连续反馈](skills/mini-program-project-intake-skill/references/intake-workflow.md)按子项保留原确认与新增未知,并按约定范围收口;[表单纠错](skills/mini-program-ui-device-skill/references/ui-device-workflow.md)核对失败后能定位、改正并保留输入。实际界面与设备效果须在目标项目验证。
  29. ---
  30. ## 核心亮点
  31. - **三平台事实层**:微信 / 支付宝 / 抖音的平台规则单一事实源,capability doctor 自动识别项目技术栈与目标平台;检测能力如实分级——微信支持确定性指纹监测,支付宝 / 抖音依赖执行时查官方与用户上报,不假装能自动检测(见[平台规则保鲜](#平台规则保鲜))。
  32. - **平台规则保鲜流水线**:执行层即时对齐官方现行文档,内容层每周检测漂移;仅审核一致的 `facts.md` 更新自动提 PR,CI 通过后自动合并,其余结果留在 issue(见[平台规则保鲜](#平台规则保鲜))。
  33. - **真实 Agent CLI 与产物级验证**:tier1 是本地静态检查;tier2/3 和独立模型判定使用真实 Agent 会话,行为版本另需 tier4 匿名项目配对门禁。3.6.0 已完成基于 ZCode / GLM 的分层评测,成品对比和最终独立质量判断使用 GLM-5.3-Flash;具体模型、覆盖范围和证据说明见 [EVALUATIONS.md](EVALUATIONS.md)。
  34. - **日常操作边界更完整**:引导 Agent 检查返回刷新、弹窗关闭重开、连续输入与自动保存、云端失败恢复,防止旧状态干扰新操作;实际效果须在目标项目验证。
  35. - **质量优先、进度可见**:推进主链路并交付可查看成果,按新改动、真实失败或证据缺口补测,及时交接用户选定的人工操作,减少重复确认与配合负担。
  36. - **证据优先工程纪律**:状态必须由匹配证据支撑,没有证据就如实标注 unknown;这套纪律沉淀为领域无关的基础技能层 `foundation/`,可被任何 Agent 工程套件复用(见[设计原则](#设计原则))。
  37. - **分层评测 + 独立签署**:tier1 结构 / tier2 路由 / tier3 行为 / tier4 匿名合成项目产物非退化,配合 with-skill 与 baseline 独立判定及冻结 held-out 批,门禁全 PASS 才发布(见 [EVALUATIONS.md](EVALUATIONS.md))。
  38. - **供应链级发布治理**:SHA256 + 双 manifest + fail-closed 出包 + 接收端复验 + 敏感信息扫描清零,六语言 README 结构一致性由脚本守护(见[包完整性](#包完整性))。
  39. ---
  40. ## 32 秒看懂这套技能
  41. 如果你想先快速了解这套 Skill 解决什么问题、从哪里沉淀出来、适合怎么用,可以先看这个 [32 秒说明视频](https://raw.githubusercontent.com/NocodeMrLi/mini-program-engineering-skill-suite/main/assets/readme-promo.mp4)。
  42. https://github.com/user-attachments/assets/d382951e-5175-48be-b0c0-44ba210706f1
  43. <sub>视频仅用于说明这套 Skill 的定位、来源和使用边界。</sub>
  44. ---
  45. ## 项目状态
  46. 本仓库是这套套件的公开项目主页,已通过 **MIT License** 开源发布。任何人都可以查看、使用、修改和再分发,具体条款见 [LICENSE](LICENSE)。
  47. ---
  48. ## 它解决了什么问题
  49. 做小程序这件事,对没接触过的人来说远比看上去复杂。真正难的往往不是写某一段代码,而是从一开始就不知道该先确认什么、哪些决策会影响后面、什么时候该停下来验证,以及上线前哪些事不能凭感觉跳过。
  50. 工具链分散、平台规则琐碎、上线审核环环相扣。无论你是第一次做小程序的产品经理 / 创业者,还是临时接手老项目的开发者,往往会在这些地方反复踩坑:
  51. - 环境装到一半报错、配置前后不一致;
  52. - 上线之后才发现权限漏配,临时补隐私协议;
  53. - UI 在不同机型上严重错位,真机表现和模拟器完全两个样子;
  54. - 提审版本和发布版本混淆,误把没验收的代码送审;
  55. - 误操作把没确认的改动推到了线上,要紧急回滚……
  56. **小程序开发工程技能套件** 把这些容易踩坑的环节打包成 Agent 可以直接执行的工程能力:先梳理目标和边界,再形成产品规格和工程方案,然后小步实现、分层验证、收口发布风险。**它不替你做商业和产品决定,但能让一个不懂小程序开发的人在 Agent 的辅助下走完从 0 到 1 的关键路径,知道下一步该做什么、为什么做、做到什么程度才算有证据。**
  57. ---
  58. ## 真实项目来源:语宠精灵
  59. 这套 Skill 不是从抽象教程里写出来的,而是从真实微信小程序「语宠精灵」的长期开发协作中提炼出来的。它沉淀的是小程序从 0 到 1 的产品拆解、工程实施、验证验收、发布准备和证据管理方法。
  60. <p align="center">
  61. <img src="assets/wordpet-origin-case.png" alt="语宠精灵真实项目来源案例:学习卡片、读一读、成长地图和小程序二维码" width="100%">
  62. </p>
  63. <sub>「语宠精灵」仅作为真实来源案例展示。本仓库只公开可复用的小程序开发工程方法,不包含该小程序源码、AppID、云资源、私有配置、业务数据、审核状态或内部开发记录。小程序二维码仅用于体验真实案例,扫码结果以微信平台当前状态为准。</sub>
  64. ---
  65. ## 它帮助 Agent 做到这些事
  66. - **接手项目**:先摸清现有的项目状态再动手改,避免破坏已有功能;
  67. - **澄清需求**:把模糊的产品想法转成可以验收的明确规格;
  68. - **沉淀决策**:把已经定了的产品决策落到架构、数据、接口、权限和兜底逻辑上;
  69. - **安全改代码**:在保留原有成果的前提下,做小颗粒、可回滚的改动;
  70. - **逐级验证**:把 UI 预览、用户确认、集成验证、机型适配、最终验收当成互相不等价的环节;
  71. - **用证据排错**:依据真实证据定位问题,而不是凭感觉猜;
  72. - **如实汇报**:老老实实报告当前验证到了哪一步,不夸大也不省略;
  73. - **平台规则保鲜**:执行发布、提审、隐私申报等平台触点步骤时,按官方现行规则执行,不被套件内置的旧规则带偏(见下文「平台规则保鲜」)。
  74. ---
  75. ## 平台规则保鲜
  76. 平台规则会持续变化,任何写死在技能里的规则都会过期。这套套件采用「**执行层即时保鲜,内容层受控进化**」:
  77. - **执行前核对官方依据**:上传、提审、发布、隐私申报和配额等步骤,要求 Agent 核对事实的日期、来源与适用范围,过期或高风险事项再查官方现行文档。无法确认时保留 unknown 并停止依赖该事实的操作;这项流程不能保证旧版本始终正确,仍需及时更新本机套件。
  78. - **套件内容受控升级**:维护方通过漂移检测工具(对官方文档做指纹比对)发现规则变化后,经多轮独立审计提交更新;你可以在 [Issues](https://github.com/NocodeMrLi/mini-program-engineering-skill-suite/issues) 用 **Platform rule drift** 模板上报你发现的规则变化(自愿,预填好格式)。
  79. - **想用最新版教材**:从 [Releases](https://github.com/NocodeMrLi/mini-program-engineering-skill-suite/releases) 下载新包并 `install.sh --force` 重装即可;套件永远不会静默自动更新你的本地安装。
  80. 平台事实与规则地图位于仓库 `platforms/` 目录,当前覆盖微信、支付宝、抖音三个平台:微信支持确定性指纹监测(每周自动漂移检测);支付宝与抖音的官方文档为客户端渲染,确定性指纹无法观测内容变化,如实标注为 manual-only——保鲜依赖执行时查官方与用户上报,不假装能自动检测。未收录的平台一律查官方并保持 unknown,不猜测。
  81. 规则摘要、核验日期与官方来源见[微信平台事实](platforms/wechat/facts.md)。执行平台操作前,仍须核对官方现行文档。
  82. ---
  83. ## 能力清单
  84. | 模块 | 作用 |
  85. | --- | --- |
  86. | 项目摸排 | 只读地摸清现有项目,输出事实清单、风险清单和变更边界 |
  87. | 产品规格 | MVP 范围、用户流程、状态矩阵、验收标准 |
  88. | 架构设计 | 模块、数据、接口、权限、异常处理策略的统一决策 |
  89. | 平台适配 | 微信小程序工具链、隐私、权限、平台方证据沉淀 |
  90. | 落地实现 | 小颗粒改动 + 测试 + 已验收成果保护 |
  91. | UI 与机型适配 | 设计稿还原、预览先行、响应式 / 多机型核验 |
  92. | 调试排错 | 复现、并列假设、根因定位、防回归验证 |
  93. | 验证 | 静态检查、单元、集成、模拟器、真机、云端、上线多层证据分级 |
  94. | 上线就绪 | 版本、构建、安全、隐私、回滚、上传 / 审核 / 发布证据治理 |
  95. ---
  96. ## 设计原则
  97. - **事实先于动作**:没摸清现状,别动项目。
  98. - **证据对齐状态**:报什么状态,就得有什么状态被真实验证过。
  99. - **环节边界明确**:预览、实现、构建、上传、审核、验收、上线、回滚 —— 这些环节互相不可替代。
  100. - **外部动作独立授权**:上传、提交审核、发布、云端改动、仓库公开放开等外部写动作,分别独立授权。
  101. - **私有信息隔离**:对外分发的包,必须先过脱敏和敏感信息检查。
  102. - **真机才是真相**:本地检查、静态检查、模拟器都不能替代真机、体验版、生产环境的真实证据。
  103. - **平台规则保鲜**:执行以官方现行规则为准,套件内置规则只作缓存不作权威。
  104. ---
  105. ## 适用场景
  106. 这套套件适合在以下场景里辅助 Agent 完成小程序工程任务 —— 尤其是当项目已经累积了产品决策、UI 约定、平台约束和发布风险之后。
  107. 典型的使用场景包括:
  108. - 接手一个陌生的小程序仓库;
  109. - 从零开始规划一个新小程序;
  110. - 在不破坏已有验收成果的前提下实现一个新功能;
  111. - 检查项目当前是否到了可以上传、提审或发布的状态;
  112. - 把反复出现的工程判断沉淀成可复用的 Agent 行为。
  113. ---
  114. ## 使用方法
  115. ### 1. 安装到支持 Agent Skill 的应用
  116. 推荐优先从 [GitHub Releases](https://github.com/NocodeMrLi/mini-program-engineering-skill-suite/releases) 下载已经导出的公开包;如果你想查看源码、参与修改或让 Agent 自动处理,也可以克隆本仓库到支持 `SKILL.md` 或项目规则的 Agent 应用目录中。
  117. 如果你不想手动执行命令,可以先把下面这句话复制给自己正在使用的 Agent。只要它有联网、Git 和本地文件写入权限,它通常可以自动判断安装位置并完成安装:
  118. ```text
  119. https://github.com/NocodeMrLi/mini-program-engineering-skill-suite.git 帮我安装这个技能
  120. ```
  121. 如果 Agent 无法访问本地文件系统,或你想自己控制安装位置,可以使用下面的安装器或命令行方式。
  122. | 应用 / 运行器 | 推荐安装位置 | 调用方式 |
  123. | --- | --- | --- |
  124. | Codex App / Codex 本地 Skills | `~/.codex/skills/mini-program-engineering-suite` | `/mini-program-engineering-suite` |
  125. | 通用 Agent Skills | `~/.agents/skills/mini-program-engineering-suite` | `/mini-program-engineering-suite` |
  126. | Claude Code | `~/.claude/skills/mini-program-engineering-suite` | `/mini-program-engineering-suite` |
  127. | GitHub Copilot Coding Agent | `.github/skills/mini-program-engineering-suite` | 在仓库任务中按 Skill 说明触发 |
  128. | Cursor | `.cursor/rules/mini-program-engineering-suite` | 作为项目规则 / Skill 说明使用 |
  129. | Windsurf / Cline / Roo Code / Gemini CLI / Kiro / Trae / Goose / OpenCode | 对应应用的 skills 或 rules 目录 | 按该应用的 Skill / Rules 机制触发 |
  130. 安装器示例:
  131. ```bash
  132. git clone https://github.com/NocodeMrLi/mini-program-engineering-skill-suite.git
  133. cd mini-program-engineering-skill-suite
  134. bash install.sh --target auto
  135. ```
  136. 如果要安装到某个项目的 GitHub Copilot 或 Cursor 规则目录,请显式传入项目路径:
  137. ```bash
  138. bash install.sh --target codex
  139. bash install.sh --target agents
  140. bash install.sh --target copilot --project /path/to/your-mini-program-project
  141. bash install.sh --target cursor --project /path/to/your-mini-program-project
  142. ```
  143. 其中 `--target codex` 对应 `~/.codex/skills`,`--target agents` 对应 `~/.agents/skills`。
  144. 安装器默认不覆盖已有目录;需要替换时加 `--force`,旧目录会先移动为带时间戳的备份。
  145. 通用安装示例:
  146. ```bash
  147. git clone https://github.com/NocodeMrLi/mini-program-engineering-skill-suite.git \
  148. ~/.agents/skills/mini-program-engineering-suite
  149. ```
  150. Claude Code 示例:
  151. ```bash
  152. git clone https://github.com/NocodeMrLi/mini-program-engineering-skill-suite.git \
  153. ~/.claude/skills/mini-program-engineering-suite
  154. ```
  155. GitHub Copilot 项目级安装示例:
  156. ```bash
  157. mkdir -p .github/skills
  158. git clone https://github.com/NocodeMrLi/mini-program-engineering-skill-suite.git \
  159. .github/skills/mini-program-engineering-suite
  160. ```
  161. ### 2. 在新会话中调用
  162. 安装后重新打开一个 Agent 会话,直接描述任务即可。支持显式调用主 Skill:
  163. ```text
  164. /mini-program-engineering-suite 我想从 0 到 1 做一个微信小程序,请先帮我梳理产品范围和开发步骤。
  165. ```
  166. 也可以直接描述阶段任务,让 Agent 路由到对应组件:
  167. ```text
  168. 帮我接手这个小程序项目,先只读看清现状,不要改代码。
  169. ```
  170. ```text
  171. 这个小程序准备提审了,帮我做发布前检查,但不要上传、不要提交审核。
  172. ```
  173. ### 3. 按阶段交付
  174. 推荐把任务拆成「产品规格 → 架构方案 → 实现 → UI / 真机适配 → 验证 → 发布准备」几个阶段推进。每一阶段都要求 Agent 说明:
  175. - 当前结论是什么;
  176. - 依据哪些文件、测试、截图、日志或平台证据;
  177. - 哪些内容还没有验证;
  178. - 下一步需要你确认什么。
  179. 已有项目一定先做只读项目摸排,再决定是否修改。上传、提交审核、发布、云端改动、仓库权限变更等外部动作,都需要单独授权。
  180. ### 更新已安装副本
  181. 仓库合并或发布 tag 不会自动替换本机技能文件。从 Releases 下载并验证公开包后,在解压目录执行:
  182. ```bash
  183. cd mini-program-engineering-suite-v3.7.0
  184. bash install.sh --target auto --force
  185. ```
  186. 安装器会先把旧目录移到原目录旁的时间戳备份;请按安装器输出的本次备份路径,将它移到技能发现目录之外。检查每个实际安装位置的 VERSION;若单独安装过子技能,也要同步其副本或入口,避免新旧混用。更新内容可在下一轮对话或新会话中读取。
  187. ---
  188. ## 它不会做什么
  189. 这套套件不会自动安装项目依赖、创建云端资源、上传包、提交审核、发布版本,或改动线上状态。它可以准备好证据和操作指引,但每个外部动作都仍需独立授权。
  190. ---
  191. ## 验证
  192. 当前套件版本在发布前会经过:结构校验、敏感信息扫描、对公包导出的确定性检查、清单核对、路由评估、行为评估和独立终审。
  193. CI 还强制全仓脚本语句覆盖率不低于 85%,评估门禁、SemVer 建议器、敏感扫描和接收端复验四个关键模块的分支覆盖率不低于 90%。minor/major 行为版本还必须提供独立匿名合成项目 baseline/with-skill 同题配对的 Tier 4 产物非退化 PASS,并用仓库可信公钥验证签名的新鲜九阶段声明;声明绑定业务候选提交,后续 tag 封装提交只允许加入当前版本脱敏证据且行为/基架指纹必须不变。patch 版本复用历史评测时,同样必须签名绑定候选 tag、来源 tag/commit、九阶段 PASS 摘要及候选行为/评测基架指纹;任一绑定不一致即阻断发布。
  194. 评测分层、证据边界与各版本公开摘要见 [EVALUATIONS.md](EVALUATIONS.md)。评测引擎与模型可插拔(codex / claude / gemini / OpenAI 兼容 API 任一可用者均可充当被测与判定引擎),审计元数据如实记录当次使用的引擎与模型;跨引擎通过是更强证据,分数不跨引擎直接比较。
  195. 接收一个包时,通过它的 `package-manifest.json` 校验完整性;源码工作副本在分发前会先经过校验和敏感扫描。
  196. 如果你克隆了本仓库,可以在本地运行零依赖自检:
  197. ```bash
  198. python3 -m unittest discover -s tests -q
  199. python3 scripts/validate_suite.py .
  200. python3 scripts/check_i18n_readme_structure.py .
  201. python3 scripts/scan_sensitive_content.py . --format json
  202. ```
  203. 发布或分发前,再执行一次确定性导出与接收端复验:
  204. ```bash
  205. export_dir="$(mktemp -d)"
  206. python3 scripts/export_public_package.py . --output "$export_dir/package"
  207. python3 "$export_dir/package/scripts/verify_public_package.py" "$export_dir/package"
  208. ```
  209. 这些命令也是 GitHub Actions CI 的核心检查项。
  210. ---
  211. ## 包完整性
  212. 请优先使用 [GitHub Releases](https://github.com/NocodeMrLi/mini-program-engineering-skill-suite/releases) 这样的 **可信来源** 中的版本化发布包,不要混用不同版本的文件;仓库中的 `VERSION` 是版本号的唯一权威。每个 Release 会附带公开包压缩文件、`package-manifest.json`、`gate-summary.json` 和覆盖三者的 `SHA256SUMS`,用于确认下载产物没有被传输损坏或混入其他版本文件。仓库已启用不可变 Release:全部附件在草稿阶段附齐,发布后 tag 与附件不可替换;`gate-summary.json` 可用于回读本次 SemVer 与签名评测门禁结论。
  213. 校验 Release 附件。Linux / GitHub Actions 可用:
  214. ```bash
  215. sha256sum -c SHA256SUMS
  216. ```
  217. macOS 可用:
  218. ```bash
  219. shasum -a 256 -c SHA256SUMS
  220. ```
  221. 然后解压并复验包内清单:
  222. ```bash
  223. tar -xzf mini-program-engineering-suite-v3.7.0.tar.gz
  224. python3 mini-program-engineering-suite-v3.7.0/scripts/verify_public_package.py \
  225. mini-program-engineering-suite-v3.7.0
  226. ```
  227. 如果你拿到的是其他渠道提供的包,也可以通过包内 `package-manifest.json` 重新计算每个文件的大小和 SHA-256 摘要:
  228. ```bash
  229. python3 <包目录>/scripts/verify_public_package.py <包目录>
  230. ```
  231. 这条命令只确认包本身的完整性,**不证明**发布者身份、平台审核结果或生产发布状态。请保留上一个已校验过的包及其清单摘要,以便后续版本回退。
  232. ---
  233. ## 当前版本
  234. 3.6.0 补强多时点外部核验、状态与身份分离,以及破坏性操作从预览到原子执行的范围绑定;沿用用户已有流程,减少无必要确认、重传和重复测试。GLM 测评范围与实际发布结果见 [EVALUATIONS.md](EVALUATIONS.md) 和 Release。
  235. 当前版本:**3.7.0**;[公开包与发布状态](https://github.com/NocodeMrLi/mini-program-engineering-skill-suite/releases/tag/v3.7.0)。版本历史见 [CHANGELOG.md](CHANGELOG.md),测评与证据边界见 [EVALUATIONS.md](EVALUATIONS.md)。
  236. v3.6.0 发布验证:386/386 项确定性测试、最终签名提交 CI 9/9、12/12 个技术及协作场景通过;两个案例共 8 份最终报告的成品对比平均提升 2.7375,候选关键错误及关键维度退化均为 0。两次最终独立质量判断、可信 RSA 验签通过;四个发布附件的校验和及 129 个公开文件与 tag 导出逐字节一致。这些受控验证不替代目标项目的真机、云端或真实交易验收,也未量化证明工程提速。
  237. ---
  238. ## 许可证
  239. 本项目采用 **MIT License** 开源发布,详见 [LICENSE](LICENSE)。你可以自由使用、修改、分发和商用本项目,但需保留版权声明与许可说明。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.