前言¶
用 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