前言¶
用 AI 改微信小程序或 uni-app 时,常见问题是改动范围失控:一句「把按钮颜色改一下」,模型可能全局替换类名、顺手重构相邻页面,或顺带「优化」未提及的逻辑。回滚和 diff 审查成本往往高于手写。
下面介绍 SkillHub 上的社区 Skill「小程序精准控制·进化版」。它的设计重心不是多写功能,而是把执行边界写进规则:严格执行开发者指令,禁止全局替换、顺手改、连带优化;只有在开发者明确授权时才开放创造空间。同时内置微信生态相关知识与踩坑经验,并带有持续学习机制。
这是什么¶
「小程序精准控制·进化版」是面向微信小程序与 uni-app 开发的 Agent Skill,坐标为 @user_8c3c5215/miniapp-precision-control-evo,当前版本 v3.3.2,来源为 community,SkillHub 分类为 dev-programming。发布者为 user_8c3c5215(页面展示作者为听风的蚕蛹)。标签 requires_api_key=false,安装该 Skill 本身不需要 API Key。
它解决的核心问题是:在样式、文案、布局等细粒度修改场景下,让 AI 助手像结对同事一样「只动你点名的文件与属性」,而不是自作主张扩大改动面。
核心功能¶
依据官方简介,已核实的能力包括以下几类。
指令边界([MANDATORY])
- 严格执行开发者指令。
- 绝对禁止「全局替换」「顺手改」「连带优化」等越权行为。
- 只在开发者明确授权时才开放创造空间。
领域知识
- 内置微信生态专家知识库。
- 内置真实踩坑经验库。
- 持续学习机制(具体实现以 Skill 包内
SKILL.md为准)。
触发与话题覆盖
Skill 说明中列出的触发词与场景包括:修改、调整、替换、删除、新增;样式、文字、颜色、字号、间距、布局;「只改」「别动其他」;以及小程序、uni-app、微信开发者工具、rpx、编译、微信支付、云开发、审核、发布、订阅消息等关键词。对话里出现上述表述时,更适合启用本 Skill。
安装与启用¶
Skill 基于通用 SKILL.md 格式,通过 SkillHub CLI 安装到当前 Agent 的 skills 目录;装错目录会导致 Agent 无法加载,需要按环境选对路径。
1、检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub:
command -v skillhub && skillhub --version
若未安装,可按 SkillHub 官方安装文档执行(完整安装含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
官方页面给出的安装提示为:根据 https://skillhub.cn/install/skillhub.md,安装 @user_8c3c5215/miniapp-precision-control-evo。对应 CLI 操作为(--dir 必须指向当前 Agent 的 skills 目录):
skillhub install user_8c3c5215/miniapp-precision-control-evo --dir <skills 目录>
常用客户端 skills 路径示例(以官方安装文档为准):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按你所用 Agent 的说明刷新或重启,使新 Skill 被加载。
3、在对话中启用¶
将 Skill 安装到对应目录后,在涉及小程序或 uni-app 的修改任务中直接描述需求即可;用「只改某处」「别动其他」等表述,与 Skill 的 [MANDATORY] 边界一致。也可按 SkillHub 页面建议,把安装提示发给 AI,由其按 skillhub.md 完成安装(需允许联网与写 skills 目录)。
典型用法¶
官方未提供独立的长示例仓库,典型用法来自简介中的触发方式:把改动范围写清楚,并带上领域关键词。
样式与布局(限定范围)
只改 pages/index/index.wxss:把顶部标题字号从 32rpx 调整为 36rpx,颜色改为 #333,不要动其他页面和 js。
文案替换(禁止全局替换)
仅在 pages/user/profile.vue 里把按钮文字「提交」改成「保存」,别做全局替换,别改逻辑。
生态相关咨询与改动
uni-app 编译到微信小程序后 rpx 在某机型上间距不对,先说明可能原因,再只调整 components/foo/foo.vue 里相关样式。
明确授权后再扩展
若需要 AI 顺带重构或优化未提及文件,需在指令里单独写明授权;否则 Skill 设计为不主动扩大改动面。
适用场景与注意¶
适合谁
- 日常维护微信小程序、uni-app 项目,需要频繁改样式、文案、间距、局部布局的开发者。
- 已使用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent,希望通过规则约束 AI 改动范围的团队。
使用注意
- SkillHub 页面统计(抓取时):评分 100000,下载 3621 次;社区来源,使用前可在 SkillHub 查看版本与说明是否更新。
- 安装务必使用
--dir指向当前 Agent 的 skills 目录,避免装到默认./skills/导致不生效。 - 本 Skill 强调「精准」与「禁止越权」,若你的任务本身就是大范围重构,应在指令中明确授权,或暂时不用该 Skill 的严格模式预期。
- 微信支付、云开发、审核、发布、订阅消息等话题依赖 Skill 内知识库与模型能力,关键上线步骤仍应以微信官方文档与审核结果为准。
结尾¶
「小程序精准控制·进化版」把微信小程序与 uni-app 场景下的常见痛点——AI 改码范围过大——收敛成可执行的 Skill 规则,并叠加微信生态与踩坑知识。若你正在 SkillHub 上选型 dev-programming 类工具,可按上文命令安装 @user_8c3c5215/miniapp-precision-control-evo(v3.3.2)。
- SkillHub 页面:https://www.skillhub.cn/skills/user_8c3c5215/miniapp-precision-control-evo
- API 坐标页:https://api.skillhub.cn/user_8c3c5215/miniapp-precision-control-evo
- 安装说明:https://skillhub.cn/install/skillhub.md