Skill cloudbase-document-database-in-wechat-miniprogram
✓ VerificadoRealiza operaciones CRUD, consultas complejas, paginación, agregación y consultas de geolocalización dentro de WeChat Mini Programs utilizando el SDK wx.cloud.database.
- Estrellas en GitHub
- 1164
- Archivos
- 8
- Último commit
- 11 nov 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill cloudbase-document-database-in-wechat-miniprogram?
Realiza operaciones CRUD, consultas complejas, paginación, agregación y consultas de geolocalización dentro de WeChat Mini Programs utilizando el SDK wx.cloud.database.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill cloudbase-document-database-in-wechat-miniprogram
La función principal de este SKILL es la gestión de datos dentro de WeChat Mini Programs. Permite a los desarrolladores realizar operaciones de base de datos de documentos directamente a través del SDK wx.cloud.database(). Un agente debe cargar esta herramienta cuando una tarea implique CRUD de colecciones en Mini Programs, paginación, agregación o consultas de geolocalización. Genera código del lado del cliente diseñado específicamente para el entorno de Mini Program, asegurando que las llamadas a la base de datos sean compatibles con el framework nativo.
Este SKILL se distingue porque se centra exclusivamente en el SDK del lado del Mini Program, en lugar del Web SDK o de las funciones en la nube del lado del servidor. Gestiona la identidad del usuario integrada a través del contexto de CloudBase y respeta los campos gestionados por el sistema como _openid. Los desarrolladores deben usarlo cuando trabajen dentro de páginas o componentes de Mini Program para garantizar que las reglas de seguridad y las comprobaciones de propiedad funcionen correctamente. No está destinado a MySQL, trabajo con bases de datos relacionales o implementaciones de @cloudbase/js-sdk basadas en el navegador.
Lo que un agente puede hacer con ella
- 1Realizar operaciones CRUD en coleccionesEscribir código para crear, leer, actualizar o eliminar documentos dentro de una colección de WeChat Mini Program.
- 2Implementar paginación de datosDesarrollar la lógica para recuperar resultados de la base de datos en fragmentos más pequeños y manejables mediante paginación.
- 3Ejecutar consultas de geolocalización complejasCrear consultas que filtren o recuperen datos basados en información de ubicación geográfica.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill cloudbase-document-database-in-wechat-miniprogram
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill cloudbase-document-database-in-wechat-miniprogram en Claude Code
~/.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-miniprogramInstalar la skill cloudbase-document-database-in-wechat-miniprogram en Claude Code (project)
.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-miniprogramInstalar la skill cloudbase-document-database-in-wechat-miniprogram en Codex
~/.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-miniprogramInstalar la skill cloudbase-document-database-in-wechat-miniprogram en Gemini CLI
~/.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-miniprogramInstalar la skill cloudbase-document-database-in-wechat-miniprogram en Claude.ai
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
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibletencentcloudbase/cloudbase-ai-toolkit/config/.claude/skills/cloudbase-document-database-in-wechat-miniprogram is public and reachablegithub.com/tencentcloudbase/cloudbase-ai-toolkit/tree/HEAD/c ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-11-11github.com/tencentcloudbase/cloudbase-ai-toolkit/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗Aprobado
- SKILL.md sigue el formato de Agent Skillsthe description does not say when to use the skillgithub.com/tencentcloudbase/cloudbase-ai-toolkit/blob/HEAD/c ↗Hallazgo
SKILL.md
Ver en GitHubSibling 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.
Archivos de esta skill
8Preguntas sobre la skill cloudbase-document-database-in-wechat-miniprogram
¿Cómo instalo la skill cloudbase-document-database-in-wechat-miniprogram en Claude Code?
Ejecuta 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 carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill cloudbase-document-database-in-wechat-miniprogram?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo inicializo la base de datos CloudBase en un WeChat Mini Program?
Puedes inicializar la base de datos usando const db = wx.cloud.database(); o especificando un entorno concreto como wx.cloud.database({ env: 'test' });.
¿Puedo establecer manualmente el campo _openid al actualizar un documento?
No, nunca debes establecer o sobrescribir manualmente el campo _openid durante las operaciones de creación o actualización, ya que es gestionado por el sistema.
¿Qué debo hacer si encuentro errores de permisos durante una consulta?
Los errores de permisos suelen indicar que la relación entre la estructura de tu consulta y las reglas de seguridad de la colección es incorrecta, en lugar de que el usuario haya cerrado sesión.