微信小程序构建助手

wechat-mini-program-builder 是一个面向 Codex 的中文 Skill，用来规划、构建、审查和完善微信原生小程序。

它会先理解真实业务，再选择必要模块，适用于商城、预约、门店、会员、内容、活动、表单和内部流程等场景。默认使用 WXML、WXSS、TypeScript 或 JavaScript 及 JSON 配置，不会把所有项目强行套入同一种商城模板。

这是一个持续迭代的个人练习项目，目前没有真实客户案例。仓库中的场景、数据和模板均用于学习与回归检查，不代表生产部署结果。

核心能力

• 将不完整的业务想法整理为产品范围、页面、流程、数据模型和验收标准。
• 根据业务选择商城、预约、门店、会员、内容、表单、角色权限等必要模块。
• 构建或改进微信原生小程序项目。
• 审查需求、截图、交互流程和已有代码。
• 检查项目结构、页面注册、导航目标、资源引用和常见安全风险。
• 通过正确与错误测试夹具回归验证项目检查脚本。
• 区分已验证功能、模拟数据、待接接口和发布阻塞项。

适用场景

• 从零规划一个微信小程序。
• 将产品方案实现为微信原生项目。
• 为现有项目增加预约、商城、表单或权限流程。
• 检查小程序代码、界面截图或用户流程。
• 在提交审核前整理验证清单和风险边界。

安装

需要已经安装 Git 和 Codex。

Windows PowerShell

git clone https://github.com/akuguaaaa-png/wechat-mini-program-builder.git "$env:USERPROFILE\.codex\skills\wechat-mini-program-builder"

macOS 或 Linux

git clone https://github.com/akuguaaaa-png/wechat-mini-program-builder.git ~/.codex/skills/wechat-mini-program-builder

安装后重新打开 Codex，确保 Skill 出现在可用技能列表中。

如果目标目录已经存在，请先确认其中是否有自己的修改，不要直接覆盖。

如何调用

在 Codex 对话中明确提及：

$wechat-mini-program-builder

也可以直接用自然语言描述微信小程序需求。Skill 配置允许在任务明显匹配时被隐式调用。

示例提示词

使用 $wechat-mini-program-builder，帮我规划并制作一个装修材料公司的微信下单小程序。

使用 $wechat-mini-program-builder，检查当前微信小程序项目，找出必须修复、建议改进和视觉润色的问题。

使用 $wechat-mini-program-builder，为一家美容院制作支持门店、员工、服务项目和时间段选择的预约小程序。

使用 $wechat-mini-program-builder，帮我规划一个摄影工作室微信小程序，支持作品展示、摄影套餐和档期预约。

工作模式

目录结构

wechat-mini-program-builder/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── assets/
│   └── starter-template/       # 中性 TypeScript 列表—详情骨架
├── references/
│   ├── booking-flow.md
│   ├── commerce-flow.md
│   ├── design-system.md
│   ├── review-checklist.md
│   ├── evaluation-scenarios.md # 模拟验收场景
│   └── ...
└── scripts/
    ├── validate-project.js
    ├── test-validator.js
    └── fixtures/

SKILL.md 是 Skill 的主入口。references/ 保存按需加载的详细规范，assets/ 提供参考模板，scripts/ 提供确定性的结构检查。

项目验证

检查验证脚本本身：

node --check scripts/validate-project.js

运行验证器回归测试：

node scripts/test-validator.js

验证仓库内置模板：

node scripts/validate-project.js assets/starter-template

验证其他微信原生小程序：

node scripts/validate-project.js /path/to/mini-program-project

当前内置模板的结构检查结果：

Summary: 0 error(s), 0 warning(s)

当前验证状态

• Skill YAML frontmatter：已通过 quick_validate.py 检查。
• SKILL.md 中声明的 reference 文件：均已确认存在。
• scripts/validate-project.js：已通过 Node.js 语法检查。
• 验证器回归测试：包含一个正确项目和一个多错误项目夹具。
• 内置 starter template：结构检查为 0 个错误、0 个警告。
• 仓库敏感材料扫描：未发现令牌、私钥、证书、.env、ZIP 或 node_modules。
• 微信开发者工具编译和真机测试：需要在具体生成项目中单独执行。

安全与能力边界

• 不要在小程序客户端或公开仓库中保存 AppSecret、商户密钥、证书、签名材料或访问令牌。
• 身份、价格、库存、预约可用性、支付和审批状态应由可信服务端校验。
• assets/starter-template/ 是中性的 TypeScript 列表—详情参考骨架，不是通用模板，也不代表生产级成品。
• 项目能够通过结构检查，不等于已经完成微信平台审核、隐私合规、支付接入或真机验证。
• 对支付、预约和权限流程，应补充服务端集成测试、重复提交保护及异常恢复测试。

贡献

欢迎通过 Issue 提交使用问题、适用场景和改进建议。提交修改前，请运行结构检查，并确保不包含个人数据、密钥、环境变量、压缩包、缓存或生成依赖。

许可证

本项目采用 MIT License。