更新多个技能文档，新增常见陷阱（Gotchas）部分，提供开发过程中需避免的错误及其解决方案，提升开发团队的规范性和效率。同时，更新描述以更清晰地指引使用场景，确保文档内容的准确性和实用性。

.cursor/skills/miniprogram-dev/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: soul-miniprogram-dev
-description: Soul 创业派对小程序开发规范。在 miniprogram/ 下编辑时必遵循。WXML/WXSS/JS、app.request、/api/miniprogram/*、scene、支付、权限。Use when editing miniprogram, 小程序, 微信原生.
+description: Trigger when 编辑 miniprogram、小程序、微信原生、C 端、调用 miniprogram 接口、支付/提现/推荐 时必读。WXML/WXSS、app.request、仅用 /api/miniprogram/*。
 ---
 # Soul 创业派对 - 小程序开发 Skill
 
@@ -123,7 +123,24 @@ description: Soul 创业派对小程序开发规范。在 miniprogram/ 下编辑
 
 ---
 
-## 12. 何时使用本 Skill
+## 12. 常见陷阱（Gotchas）
+
+> 从实际失败中积累，持续补充。**千万别这么做**——对 AI 信号更强。
+
+| 陷阱 | 后果 | 正确做法 |
+|------|------|---------|
+| 调用 `/api/admin/*`、`/api/db/*` | 路由互窜、鉴权不符 | 仅用 `/api/miniprogram/*` |
+| 页面里直接 `wx.request` 写死 baseUrl | 配置分散、难切换环境 | 统一 `getApp().request(url, options)` |
+| 在 input/textarea 自身上设 padding | 光标截断、布局异常 | 外边包 view，padding 写在 view，input `width:100%` |
+| button 包裹目标元素做 chooseAvatar | 原生样式干扰（灰框、边框） | button 绝对定位覆盖，同级关系，透明背景 |
+| 分享链路（支付/领取/代付）不判断单页模式 | 朋友圈打开能力受限、报错 | `wx.getSystemInfoSync()?.mode === 'singlePage'` 时引导「前往小程序」 |
+| 支付前不校验头像/昵称 | 超级个体开通后资料为默认 | 支付前校验，不通过则 `navigateTo('/pages/avatar-nickname/avatar-nickname')` |
+| app.onLaunch 中集中请求隐私授权 | 平台合规风险、审核不通过 | 按需授权，用户**实际触发功能时**再请求 |
+| 用 `selectable` 做文本复制 | 已废弃 | 用 `<text user-select>...</text>`（基础库 2.12.1+） |
+
+---
+
+## 13. 何时使用本 Skill
 
 - 在 **miniprogram/** 下新增或修改页面、组件、utils 时。
 - 在小程序内新增或修改任何网络请求路径时（必须保持 `/api/miniprogram/...`）。