$npx -y skills add TencentCloudBase/cloudbase-skills --skill miniprogram-developmentWeChat Mini Program development skill for building, debugging, previewing, testing, publishing, and optimizing mini program projects. This skill should be used when users ask to create, develop, modify, debug, preview, test, deploy, publish, launch, review, or optimize WeChat Min
| 1 | ## Standalone Install Note |
| 2 | |
| 3 | If this environment only installed the current skill, start from the CloudBase main entry and use the published `cloudbase/references/...` paths for sibling skills. |
| 4 | |
| 5 | - CloudBase main entry: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/SKILL.md` |
| 6 | - Current skill raw source: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/miniprogram-development/SKILL.md` |
| 7 | |
| 8 | Keep local `references/...` paths for files that ship with the current skill directory. When this file points to a sibling skill such as `auth-tool` or `web-development`, use the standalone fallback URL shown next to that reference. |
| 9 | |
| 10 | **Cross-cutting protocols** (required before code changes or uploads): |
| 11 | - Change Safety Protocol: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/cloudbase-platform/references/protocols/change-safety-protocol.md` |
| 12 | - Deployment Gate: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/cloudbase-platform/references/protocols/deployment-gate.md` |
| 13 | |
| 14 | ## Activation Contract |
| 15 | |
| 16 | ### Use this first when |
| 17 | |
| 18 | - The request is about WeChat Mini Program structure, pages, preview, publishing, or CloudBase mini program integration. |
| 19 | |
| 20 | ### Read before writing code if |
| 21 | |
| 22 | - The user mentions `wx.cloud`, CloudBase mini programs, OPENID, or mini program deployment/debug workflows. |
| 23 | |
| 24 | ### Then also read |
| 25 | |
| 26 | - CloudBase auth -> `../auth-wechat/SKILL.md` (standalone fallback: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/auth-wechat/SKILL.md`) |
| 27 | - CloudBase document DB -> `../no-sql-wx-mp-sdk/SKILL.md` (standalone fallback: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/no-sql-wx-mp-sdk/SKILL.md`) |
| 28 | - Mini Program WeChat Pay or Integration Center generated payment functions -> `../cloudbase-wechat-integration/SKILL.md` (standalone fallback: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/cloudbase-wechat-integration/SKILL.md`; official docs: `https://docs.cloudbase.net/integration/wechat-pay-miniprogram/index.md`) |
| 29 | - UI generation -> `../ui-design/SKILL.md` (standalone fallback: `https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills/-/git/raw/main/skills/cloudbase/references/ui-design/SKILL.md`) first |
| 30 | |
| 31 | ### Do NOT use for |
| 32 | |
| 33 | - Web auth flows or Web SDK-specific frontend implementation. |
| 34 | - WeChat Pay, payment callbacks, refunds, or Official Account OAuth details; use `cloudbase-wechat-integration` for those scenarios. |
| 35 | |
| 36 | ### Common mistakes / gotchas |
| 37 | |
| 38 | - Generating a Web-style login flow for mini programs. |
| 39 | - Mixing Web SDK assumptions into `wx.cloud` projects. |
| 40 | - Applying CloudBase constraints before confirming the project actually uses CloudBase. |
| 41 | - Making code or configuration changes without first following the Change Safety Protocol (`cloudbase-platform/references/protocols/change-safety-protocol.md`). |
| 42 | - Performing mini program upload/publish without first completing the checks in `cloudbase-platform/references/protocols/deployment-gate.md`. |
| 43 | |
| 44 | ## When to use this skill |
| 45 | |
| 46 | Use this skill for **WeChat Mini Program development** when you need to: |
| 47 | |
| 48 | - Build or modify mini program pages and components |
| 49 | - Organize mini program project structure and configuration |
| 50 | - Debug, preview, or publish mini program projects |
| 51 | - Work with WeChat Developer Tools workflows |
| 52 | - Handle mini program runtime behavior, assets, or page config files |
| 53 | - Integrate CloudBase in a mini program project when explicitly needed |
| 54 | |
| 55 | **Do NOT use for:** |
| 56 | - Web frontend development (use `web-development`) |
| 57 | - Pure backend service development (use `cloudrun-development` or `cloud-functions` as appropriate) |
| 58 | - UI design-only tasks without mini program development context (use `ui-design`) |
| 59 | |
| 60 | --- |
| 61 | |
| 62 | ## How to use this skill (for a coding agent) |
| 63 | |
| 64 | 1. **Start with the general mini program workflow** |
| 65 | - Treat WeChat Mini Program development as the default scope |
| 66 | - Do not assume the project uses CloudBase unless the user or codebase indicates it |