微信小程序 AI 协作规范生成器(AGENTS.md)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3ff3c268/wechat-miniprogram-devrules。
技能介绍
要解决的问题
AI 参与微信小程序开发时,常见风险不是“不会写代码”,而是行为越界:擅自重构无关模块、把密钥写进代码、跳过确认执行不可逆操作、改完引用不同步,甚至把项目需求混进通用规范。对小程序项目,问题会被分包、Canvas、模板锁定、多板块命名进一步放大。
技能如何工作
这个技能把协作规则从口头要求变成可生成、可检查的项目文件:
- 渲染项目根目录的
AGENTS.md,让 AI 每次开工先读约束。 - 内置 安全、稳定、沟通、最小改动、引用同步 五类基线,并把支付、删除、
.env、Git 提交等列为高优先级红线。 - 对分包和 Canvas 场景增加强化规则,例如命名隔离、核心模板锁定、Canvas 尺寸与绘制顺序约束。
- 支持
--check扫描工程是否存在硬编码密钥、.env入库等违规。 - 通过
--self-test回读生成结果,校验关键原则是否齐全。
适用边界
它提供的是通用协作基线,不包含具体 MVP 范围、接口清单或业务文档索引。技术栈默认按微信小程序、FastAPI 与数据库给出约定,换栈时需要更新对应段落。规范仍需要人工监督,交付验收应单独执行。
使用场景
- 新建微信小程序项目时,生成项目根目录 `AGENTS.md`,让 AI 先读取安全与最小改动约束。
- AI 准备重构分包模块前,用命名隔离规则检查是否会误用其他板块变量和函数。
- 交付前执行 `--check`,扫描代码是否出现硬编码密钥或 `.env` 文件入库等安全违规。
- 处理 Canvas 课业模板开发时,按 A4 尺寸、绘制顺序和字体回退约束组织 AI 输出。
适合人员
- 负责微信小程序主项目的技术负责人,希望把 AI 协作红线写进项目根目录文件。
- 做分包工具模块的前端工程师,需要在多个板块间避免命名冲突和误改文件。
- 维护 Canvas 课业模板的前端开发者,要控制 A4 尺寸、绘制顺序和字体回退等细节。
- 管理 AI 辅助交付的工程负责人,想在交付前检查密钥、`.env` 和 Git 提交风险。