miniprogram-development skill
✓ 인증됨CloudBase 통합 및 SEO를 포함하여 WeChat Mini Program의 개발, 디버깅, 미리보기, 게시 및 최적화를 지원합니다.
- GitHub 스타
- 1,164
- 파일
- 8
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
- 허용된 도구
- —
miniprogram-development skill은 무엇을 하나요?
CloudBase 통합 및 SEO를 포함하여 WeChat Mini Program의 개발, 디버깅, 미리보기, 게시 및 최적화를 지원합니다.
skill의 SKILL.md에서 생성된 요약입니다.
miniprogram-development skill 정보
이 SKILL은 개발자가 WeChat Mini Program을 구축, 디버깅 및 배포할 수 있도록 지원합니다. 프로젝트 구조 관리, project.config.json과 같은 설정 파일 구성, tabBar 아이콘과 같은 에셋 처리에 필요한 도구를 제공합니다. 사용자가 페이지를 수정하거나, 라우팅을 정리하거나, 앱 설정을 관리해야 할 때 Agent가 이 SKILL을 사용합니다.
이 SKILL은 wechatide CLI를 사용하여 WeChat Developer Tools Nightly 워크플로우와 통합되며, 프로젝트 미리보기 및 업로드를 위해 miniprogram-ci를 지원합니다. 또한 wx.cloud를 사용하는 프로젝트를 위해 CloudBase 통합을 지원하여 클라우드 함수 및 데이터베이스 관리가 가능합니다. 핵심 개발 외에도 미니 프로그램 SEO, 검색 인덱싱, 메시지 푸시 기능을 통한 고객 서비스 자동 응답 설정과 같은 전문적인 작업도 처리합니다.
이 도구는 WeChat 생태계에 특화되어 설계되었으므로 일반적인 웹 프론트엔드 개발이나 순수 백엔드 서비스용으로 사용해서는 안 됩니다. WeChat 환경 내에서 성공적인 배포와 미리보기를 보장하기 위해 appid 및 miniprogramRoot와 같은 특정 설정에 의존합니다.
agent가 수행할 수 있는 작업
- 1프로젝트 설정 관리project.config.json 및 appid를 사용하여 프로젝트 구조와 설정을 구성합니다.
- 2배포 워크플로우 자동화wechatide CLI 또는 miniprogram-ci를 사용하여 미니 프로그램 프로젝트를 미리보고 업로드합니다.
- 3클라우드 서비스 통합클라우드 기반 기능을 위해 미니 프로그램 프로젝트를 CloudBase에 연결합니다.
- 4검색 가시성 최적화SEO 기술을 통해 미니 프로그램의 검색 인덱싱 및 홍보를 개선합니다.
- 5자동 메시징 구성고객 서비스 자동 응답 및 메시지 푸시 기능을 설정합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
miniprogram-development skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 miniprogram-development skill 설치
~/.claude/skills/miniprogram-development/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/miniprogram-development ~/.claude/skills/miniprogram-developmentClaude Code (project)에 miniprogram-development skill 설치
.claude/skills/miniprogram-development/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/miniprogram-development .claude/skills/miniprogram-developmentCodex에 miniprogram-development skill 설치
~/.agents/skills/miniprogram-development/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/miniprogram-development ~/.agents/skills/miniprogram-developmentGemini CLI에 miniprogram-development skill 설치
~/.gemini/skills/miniprogram-development/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/miniprogram-development ~/.gemini/skills/miniprogram-developmentClaude.ai에 miniprogram-development skill 설치
npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/miniprogram-development miniprogram-development && zip -r miniprogram-development.zip miniprogram-development # claude.ai → Customize → Skills → + → Create skill → Upload a skill → miniprogram-development.zip
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능tencentcloudbase/cloudbase-ai-toolkit/config/.claude/skills/miniprogram-development is public and reachablegithub.com/tencentcloudbase/cloudbase-ai-toolkit/tree/HEAD/c ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-11github.com/tencentcloudbase/cloudbase-ai-toolkit/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 237 linesgithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗통과
SKILL.md
GitHub에서 보기Sibling skills (local only)
Sibling CloudBase skills ship beside this skill. Use local relative paths such as ../auth-tool-cloudbase/SKILL.md.
If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do not HTTP-fetch remote skill or protocol markdown into the agent context.
Cross-cutting protocols (required before code changes or deployments):
- Change Safety Protocol:
../cloudbase-platform/references/protocols/change-safety-protocol.md - Deployment Gate:
../cloudbase-platform/references/protocols/deployment-gate.md
Post-deployment (optional, non-intrusive): after a mini program upload/publish is verified successful, you may offer at most once to generate anonymized shareables (visual card + paste-ready copy) and, in that same offer, optionally submit the work to the case wall — see ../cloudbase-platform/references/protocols/deployment-share.md for trigger boundaries, required information, anonymization red lines, and deliverable formats. Never follow up if declined; never publish or submit on the user's behalf.
Activation Contract
Use this first when
- The request is about WeChat Mini Program structure, pages, preview, publishing, or CloudBase mini program integration.
- The user asks about mini program account registration or subject type (个人 / 个体工商户 / 企业主体, 快速注册并认证小程序, 小程序主体变更), or reports that the DevTools 云开发 entry is grayed out or their environment cannot be found.
- The user asks to connect / onboard a mini program project to CloudBase for the first time (帮我接入云开发,我主要做微信小程序开发、配置微信开发者工具 Skill), including when the workspace has no application code yet.
Read before writing code if
- The user mentions
wx.cloud, CloudBase mini programs, OPENID, mini program deployment/debug workflows, Nightly DevTools,wechatide, or WeChat IDE Skills. - The user mentions 测试号 / trial accounts, a grayed-out 云开发 entry, or a mini program environment that is invisible in DevTools.
- The user mentions message push (消息推送), customer-service auto-reply (客服消息/自动回复), or binding MsgType/Event callbacks to cloud functions.
Then also read
- CloudBase auth ->
../auth-wechat-miniprogram/SKILL.md - CloudBase document DB ->
../cloudbase-document-database-in-wechat-miniprogram/SKILL.md - Mini Program WeChat Pay, 虚拟支付 (virtual payment,
wx.requestVirtualPayment), or Integration Center generated payment functions ->../cloudbase-wechat-integration/SKILL.md(official docs:https://docs.cloudbase.net/integration/wechat-pay-miniprogram.md) - UI generation ->
../ui-design/SKILL.mdfirst - First-time CloudBase onboarding -> CloudBase integration reference §0.2 (公众平台登录 / 开通环境) and WeChat DevTools Debug and Preview (DevTools Skill + preview acceptance)
Do NOT use for
- Web auth flows or Web SDK-specific frontend implementation.
- WeChat Pay, 虚拟支付 /
wx.requestVirtualPayment, payment callbacks, refunds, or Official Account OAuth details; usecloudbase-wechat-integrationfor those scenarios.
Common mistakes / gotchas
- Generating a Web-style login flow for mini programs.
- Mixing Web SDK assumptions into
wx.cloudprojects. - Applying CloudBase constraints before confirming the project actually uses CloudBase.
- Assuming Stable WeChat Developer Tools includes Nightly Skills/
wechatide(it may not). - Running
which wechatide, finding nothing, and quietly switching to manual import. Missingwechatideis a setup gap to report and offer to fix, not an environment limit — state that Nightly is required, offer to install it, and wait for the user's decision before falling back. - Forcing CloudBase MCP Tencent Cloud login for daily mini program cloud ops when Nightly
wechatidealready works. - Inventing
wechatidetool names or flags instead of using--help/ Nightlytools.yaml. - Bypassing wxide CLI / IDE for message-push ops with low-level transport before
cloud_*_msg_pushis exposed (see message-push-customer-service.md). - Assuming cloud-function return values auto-reply to customer-service chats (must use
cloud.openapi.customerServiceMessage.send). - Treating a grayed-out 云开发 entry, or an environment missing from DevTools, as a DevTools bug — trial/test accounts do not support CloudBase, and when the mini program's bound Tencent Cloud account differs from the account that created the environment, the environment is simply not listed. Diagnose the cause before touching the project (see Common Pitfalls §6).
- Recommending a personal-subject (个人主体) mini program account because registration is free — personal subjects cannot bind a WeChat Pay merchant account, so physical goods and offline services are out; they also have far fewer service categories, and switching subject later requires notarization plus a paid review. The reverse mistake is just as bad: do not push a virtual-goods-only idea to a company account on the grounds that "personal cannot take payments" — 虚拟支付 is open to personal subjects whose service category includes 工具. Ask what the app will sell before recommending a subject (see CloudBase integration reference §0.1).
- Making code or configuration changes without first following the Change Safety Protocol (
cloudbase-platform/references/protocols/change-safety-protocol.md). - Performing mini program upload/publish without first completing the checks in
cloudbase-platform/references/protocols/deployment-gate.md.
When to use this skill
Use this skill for WeChat Mini Program development when you need to:
- Build or modify mini program pages and components
- Organize mini program project structure and configuration
- Debug, preview, or publish mini program projects
- Work with WeChat Developer Tools workflows
- Handle mini program runtime behavior, assets, or page config files
- Integrate CloudBase in a mini program project when explicitly needed
Do NOT use for:
- Web frontend development (use
web-development) - Pure backend service development (use
cloudrun-developmentorcloud-functionsas appropriate) - UI design-only tasks without mini program development context (use
ui-design)
How to use this skill (for a coding agent)
-
Start with the general mini program workflow
- Treat WeChat Mini Program development as the default scope
- Do not assume the project uses CloudBase unless the user or codebase indicates it
-
Follow mini program project conventions
- Keep mini program source under the configured mini program root
- Ensure page files include the required configuration file such as
index.json - Check
project.config.jsonbefore suggesting preview or IDE workflows
-
Route by scenario
- If the task involves debugging, previewing, publishing, opening DevTools, console/network, or
wechatide, read debug and preview reference first - If choosing between WeChat IDE Skills and CloudBase MCP, read WeChat IDE Skills vs CloudBase MCP
- If the task involves CloudBase,
wx.cloud, cloud functions, CloudBase database/storage, or CloudBase identity handling, read CloudBase integration reference - If the task hits account / subject prerequisites (小程序尚未注册、主体选择、测试号、云开发入口置灰、环境看不到), read CloudBase integration reference section 0 first
- If the task involves mini program SEO / WeChat search optimization / page indexing / search promotion (小程序搜索优化、页面收录、搜索推广、关键词排名), read Mini Program SEO & WeChat Search Optimization first
- If the task involves message push (消息推送), customer-service auto-reply (客服消息自动回复), MsgType/Event → cloud function binding, or push-related function logs, read Message Push & Customer Service Auto-Reply first
- If the task involves
tabBar, icon assets, or label spacing, prefer the text-only customtabBardefault below unless the user explicitly requires icons
- If the task involves debugging, previewing, publishing, opening DevTools, console/network, or
- If the user asks to connect / onboard a mini program project to CloudBase (帮我接入云开发,我主要做微信小程序开发、首次接入), read CloudBase integration reference §0.2 and debug and preview reference first. Recommend configuring the WeChat DevTools Skill and verify the simulator preview before taking business requests — a backend-only setup cannot open the simulator.
-
Use CloudBase rules only when applicable
- CloudBase / 微信云开发 is an important mini program integration path, but not a universal requirement
- Only apply CloudBase-specific auth, database, storage, or cloud function constraints when the project is using CloudBase
-
Recommend the right preview/debug/cloud-ops path
- Default target: Nightly WeChat Developer Tools (built-in Skills/MCP), executed through
wechatide— see devtools-debug-preview.md - Nightly download: https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly_backup.html
- A missing
wechatideis a one-time setup gap, not an environment limit. Tell the user Nightly is required for the CLI-driven path, offer to download/install it, and wait for their answer. Only after they decline or cannot install do you continue withminiprogram-ci+ CloudBase MCP. - Never present stable DevTools + hand import as the recommended default, and never make the "keep it simple" trade-off on the user's behalf. Manual import is a downgrade the user chooses, not one you assign.
- Default target: Nightly WeChat Developer Tools (built-in Skills/MCP), executed through
WeChat Mini Program Development Rules
General Project Rules
-
Project Structure
- Mini program code should follow the project root configured in
project.config.json - Keep page-level files complete, including
.jsonconfiguration files - Ensure referenced local assets actually exist to avoid compile failures
- Mini program code should follow the project root configured in
-
Configuration Checks
- Check
project.config.jsonbefore opening, previewing, or publishing a project - Confirm
appidis available when a real preview, upload, or WeChat Developer Tools workflow is required - Confirm
miniprogramRootand related path settings are correct
- Check
-
Resource Handling
- For
tabBar, prefer a text-only customtabBarby default when the user does not explicitly need icons. This avoids icon asset handling, removes reserved icon space, and makes the label area easier to align. - Only generate local icon assets and configure
iconPath/selectedIconPathwhen the user explicitly asks for tab icons or the design requires them. - When generating local asset references such as icons, ensure the files are downloaded into the project.
- Keep file paths stable and consistent with mini program config files.
- For
Recommended default for simple tabBar
Use tabBar.custom = true, keep only pagePath and text in app.json, and render text-only items in the custom component so there is no icon slot and no extra blank area above the label.
app.json
{
"tabBar": {
"custom": true,
"list": [
{ "pagePath": "pages/index/index", "text": "首页" },
{ "pagePath": "pages/travel/travel", "text": "行程" },
{ "pagePath": "pages/my/my", "text": "我的" }
]
}
}
Keep the custom tabBar layout text-only, and use flex centering or matching height and line-height to remove the blank area above the label. Switch to downloaded local icons only when the user explicitly wants icon-based tabs.
CloudBase as a Mini Program Sub-Scenario
- If the user explicitly uses CloudBase,
wx.cloud, Tencent CloudBase, 腾讯云开发, or 云开发, follow the CloudBase integration reference - In CloudBase mini program projects, use
wx.cloudAPIs and CloudBase environment configuration appropriately - Do not apply CloudBase-specific rules to non-CloudBase mini program projects
Debugging, Preview, and Publishing
- Default path: Nightly DevTools +
wechatidefor open project, compile, simulator, console/network debug, preview, upload, and daily cloud ops (WeChat login — no separate Tencent Cloud login) - Always pass required context:
-c <clientName>, absolute--project, validappid, and cloudenvwhen needed - If
wechatideis missing: report it as a setup gap, state that Nightly is required for the CLI-driven path, offer to install it, and wait for the user's answer — do not downgrade on your own - Only after the user declines or cannot install Nightly: use
miniprogram-cifor preview/upload/npm plus CloudBase MCP for cloud resources, and say which capabilities are now missing (simulator, console/network, automation, CLI cloud ops) - For detailed workflows, read debug and preview reference and WeChat IDE Skills vs CloudBase MCP
Message Push & Customer Service Auto-Reply
微信生态专章:消息推送 / 客服自动回复细节以中文 reference 为准(术语保留英文 API 名)。
- Current only ops path: WeChat Developer Tools IDE + wxide CLI. Do not teach low-level bypasses while
cloud_query_msg_push/cloud_manage_msg_pushare not yet exposed (pending WeChat IDE CLI support). - Deploy receiver functions with
cloud_fn_deployand--remote-npm-install; bind (MsgType, Event) → one cloud function in the IDE message-push panel until CLI tools land. - Customer-service auto-reply requires
cloud.openapi.customerServiceMessage.sendplusconfig.jsonopenapi permissions — function return values alone do not reply. - Function logs: IDE 云开发控制台 → 云函数 → 日志; the wxide CLI does not expose log query yet — do not teach low-level log CGI bypasses.
- Full reference: Message Push & Customer Service Auto-Reply
Minimal project skeleton
app.js
App({
onLaunch() {
console.log("Mini Program launched");
},
});
pages/index/index.js
Page({
data: {
message: "Hello CloudBase Mini Program",
},
});
pages/index/index.wxml
<view class="page">
<text>{{message}}</text>
</view>
pages/index/index.json
{
"navigationBarTitleText": "Home"
}
project.config.json
{
"appid": "your-mini-program-appid",
"projectname": "cloudbase-mini-program",
"miniprogramRoot": "./",
"compileType": "miniprogram"
}
References
- CloudBase Mini Program Integration — use this when the mini program project explicitly integrates CloudBase
- WeChat DevTools Debug and Preview — Nightly /
wechatidepaths, required context, and no-Nightly fallbacks - WeChat IDE Skills vs CloudBase MCP — layering and when to use which execution surface
- Message Push & Customer Service Auto-Reply — 消息推送 / 客服自动回复 via wxide CLI + IDE (no low-level bypass; pending
cloud_*_msg_push) - Mini Program SEO & WeChat Search Optimization — 小程序搜索优化 / page indexing / search promotion (
mpcrawler, URL reachability,navigatorjumps, titles & thumbnails) - Common Pitfalls — read before generating code for optional chaining, TDesign styling, Canvas + storage, and the 云开发 entry / environment issues (§6)
이 스킬의 파일
8miniprogram-development skill 질문
Claude Code에 miniprogram-development skill을 어떻게 설치하나요?
npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/miniprogram-development ~/.claude/skills/miniprogram-development를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
miniprogram-development skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
DevTools에서 CloudBase 항목이 비활성화되어 있으면 어떻게 해야 하나요?
체험용 또는 테스트 계정이 CloudBase를 지원하지 않거나, 연결된 Tencent Cloud 계정이 환경을 생성한 계정과 다를 때 주로 발생합니다. 설정을 변경하기 전에 계정 유형과 연결 상태를 먼저 확인해야 합니다.
개인 사업자 미니 프로그램 계정으로 모든 기능을 사용할 수 있나요?
개인 계정은 WeChat Pay 가맹점 계정을 연결할 수 없으므로 실물 상품이나 오프라인 서비스를 판매할 수 없습니다. 다만, 서비스 카테고리에 'Tools'가 포함된 경우 개인 계정도 가상 결제를 사용할 수 있습니다.
디버깅 및 미리보기를 위한 권장 워크플로우는 무엇인가요?
wechatide CLI를 사용하여 Nightly 버전의 WeChat Developer Tools를 사용하는 것이 기본 대상입니다. wechatide가 없는 경우 설정이 누락된 것으로 간주되므로, Nightly 버전을 설치하여 해결해야 합니다.