cloudbase-document-database-in-wechat-miniprogram skill
✓ 인증됨wx.cloud.database SDK를 사용하여 WeChat Mini Program 내에서 CRUD 작업, 복잡한 쿼리, 페이지네이션, 집계 및 지리 위치 쿼리를 수행합니다.
- GitHub 스타
- 1,164
- 파일
- 8
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
- 허용된 도구
- —
cloudbase-document-database-in-wechat-miniprogram skill은 무엇을 하나요?
wx.cloud.database SDK를 사용하여 WeChat Mini Program 내에서 CRUD 작업, 복잡한 쿼리, 페이지네이션, 집계 및 지리 위치 쿼리를 수행합니다.
skill의 SKILL.md에서 생성된 요약입니다.
cloudbase-document-database-in-wechat-miniprogram skill 정보
WeChat Mini Program 내의 데이터를 관리하는 것이 이 SKILL의 주요 기능입니다. 개발자는 wx.cloud.database() SDK를 통해 문서 데이터베이스 작업을 직접 수행할 수 있습니다. 에이전트는 Mini Program 컬렉션의 CRUD, 페이지네이션, 집계 또는 지리 위치 쿼리와 관련된 작업이 포함될 때 이 도구를 로드해야 합니다. 이 도구는 Mini Program 환경에 특화된 클라이언트 측 코드를 생성하여 데이터베이스 호출이 네이티브 프레임워크와 호환되도록 보장합니다.
이 SKILL은 Web SDK나 서버 측 클라우드 함수가 아닌 Mini Program 측 SDK에만 집중한다는 점에서 차별화됩니다. CloudBase 컨텍스트를 통해 내장된 사용자 ID를 처리하며 _openid와 같은 시스템 관리 필드를 준수합니다. 보안 규칙과 소유권 확인이 올바르게 작동하도록 하려면 Mini Program 페이지 또는 컴포넌트 내에서 작업할 때 반드시 이 도구를 사용해야 합니다. MySQL, 관계형 데이터베이스 작업 또는 브라우저 기반의 @cloudbase/js-sdk 구현을 위한 용도가 아닙니다.
agent가 수행할 수 있는 작업
- 1컬렉션 CRUD 작업 수행WeChat Mini Program 컬렉션 내에서 문서를 생성, 읽기, 업데이트 또는 삭제하는 코드를 작성합니다.
- 2데이터 페이지네이션 구현페이지네이션을 사용하여 데이터베이스 결과를 관리 가능한 작은 단위로 가져오는 로직을 개발합니다.
- 3복잡한 지리 위치 쿼리 실행지리적 위치 데이터를 기반으로 데이터를 필터링하거나 검색하는 쿼리를 생성합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
cloudbase-document-database-in-wechat-miniprogram skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 cloudbase-document-database-in-wechat-miniprogram skill 설치
~/.claude/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.claude/skills/cloudbase-document-database-in-wechat-miniprogramClaude Code (project)에 cloudbase-document-database-in-wechat-miniprogram skill 설치
.claude/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram .claude/skills/cloudbase-document-database-in-wechat-miniprogramCodex에 cloudbase-document-database-in-wechat-miniprogram skill 설치
~/.agents/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.agents/skills/cloudbase-document-database-in-wechat-miniprogramGemini CLI에 cloudbase-document-database-in-wechat-miniprogram skill 설치
~/.gemini/skills/cloudbase-document-database-in-wechat-miniprogram/SKILL.md
$ npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.gemini/skills/cloudbase-document-database-in-wechat-miniprogramClaude.ai에 cloudbase-document-database-in-wechat-miniprogram skill 설치
npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram cloudbase-document-database-in-wechat-miniprogram && zip -r cloudbase-document-database-in-wechat-miniprogram.zip cloudbase-document-database-in-wechat-miniprogram # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cloudbase-document-database-in-wechat-miniprogram.zip
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능tencentcloudbase/cloudbase-ai-toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram 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 형식을 따름the description does not say when to use the skillgithub.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.
CloudBase Document Database WeChat Mini Program SDK
Activation Contract
Use this first when
- A WeChat Mini Program must access CloudBase document database through
wx.cloud.database(). - The request mentions Mini Program collection CRUD, pagination, aggregation, or geolocation queries.
- Moving that Mini Program app's data onto CloudBase PG while keeping
wx.cloud.database()is pgdoc — read../postgresql-development-cloudbase/references/pgdoc.mdbefore changing any SDK call. CUSTOM security rules do not apply after pgdoc takes over.
Read before writing code if
- The task is Mini Program database work but you still need to separate it from Web SDK, cloud functions, or SQL tasks.
- The request depends on built-in user identity,
_openid, or Mini Program-side permissions.
Then also read
- Mini Program project rules and CloudBase integration ->
../miniprogram-development/SKILL.md - Mini Program auth and identity flow ->
../auth-wechat-miniprogram/SKILL.md - Browser-side document database code ->
../cloudbase-document-database-web-sdk/SKILL.md
Do NOT use for
- Browser/Web code using
@cloudbase/js-sdk. - Server-side or cloud-function database access.
- MySQL / relational database work.
Common mistakes / gotchas
- Copying Web SDK code into Mini Program pages.
- Manually writing
_openidduring create or update operations. - Assuming built-in Mini Program identity means security rules can be ignored.
- Mixing collection CRUD and backend-wide admin workflows in the same client path.
Minimal checklist
- Confirm the caller is a Mini Program page/component or Mini Program-side logic.
- Initialize
wx.cloudcorrectly before database calls. - Verify whether the collection rules rely on
auth.openid/_openid. - Read the specific companion reference file for the operation you need.
Overview
This skill covers Mini Program-side document database access through wx.cloud.database().
Use it for:
- collection CRUD in Mini Program pages
- query composition and pagination
- aggregation
- geolocation queries
Mini Program CloudBase access comes with built-in identity, but database operations are still constrained by collection permissions and security rules.
Canonical initialization
const db = wx.cloud.database();
const _ = db.command;
To target a specific environment:
const db = wx.cloud.database({
env: "test"
});
Important notes:
- Users are authenticated through the Mini Program CloudBase context.
- In cloud functions, caller identity is available through
wxContext.OPENID. - In client-side collection rules, ownership checks usually use
auth.openid/doc._openid.
Quick routing
- CRUD ->
./crud-operations.md - Complex queries ->
./complex-queries.md - Pagination ->
./pagination.md - Aggregation ->
./aggregation.md - Geolocation ->
./geolocation.md - Security rules ->
./security-rules.md
Working rules for a coding agent
-
Keep Mini Program code Mini Program-native
- Use
wx.cloud.database(). - Do not substitute browser SDK initialization patterns.
- Use
-
Respect ownership fields
_openidis system-managed for SDK writes.- Never set or override
_openidmanually in.add(),.set(), or.update()payloads.
-
Remember that security rules validate requests
- If a rule requires ownership conditions, the query shape must match that rule model.
- Permission errors usually mean the rule/query relationship is wrong, not only that the user is logged out.
-
Route admin-style operations to backend flows
- If the task needs privileged global access, use backend tools or functions instead of exposing that path directly in Mini Program client code.
Quick examples
Basic collection access
const todos = db.collection("todos");
const result = await todos.where({ completed: false }).get();
Document reference
const todo = db.collection("todos").doc("todo-id");
const result = await todo.get();
Best practices
- Create clear collection naming conventions.
- Use typed wrappers or model helpers in app code where possible.
- Design rules around real ownership and sharing patterns.
- Use pagination instead of large unbounded reads.
- Keep admin/operations logic in backend code, not Mini Program direct access.
이 스킬의 파일
8cloudbase-document-database-in-wechat-miniprogram skill 질문
Claude Code에 cloudbase-document-database-in-wechat-miniprogram skill을 어떻게 설치하나요?
npx degit TencentCloudBase/CloudBase-AI-Toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram ~/.claude/skills/cloudbase-document-database-in-wechat-miniprogram를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
cloudbase-document-database-in-wechat-miniprogram skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
WeChat Mini Program에서 CloudBase 데이터베이스를 초기화하려면 어떻게 해야 하나요?
const db = wx.cloud.database();를 사용하거나 wx.cloud.database({ env: 'test' });와 같이 특정 환경을 지정하여 데이터베이스를 초기화할 수 있습니다.
문서를 업데이트할 때 _openid 필드를 수동으로 설정할 수 있나요?
아니요, _openid 필드는 시스템에서 관리하므로 생성 또는 업데이트 작업 중에 수동으로 설정하거나 덮어쓰면 안 됩니다.
쿼리 중에 권한 오류가 발생하면 어떻게 해야 하나요?
권한 오류는 일반적으로 사용자가 로그아웃된 것이 아니라, 쿼리 형태와 컬렉션 보안 규칙 사이의 관계가 올바르지 않음을 의미합니다.