본문으로 건너뛰기
cccskills
무료GitHub에 공개

cloudbase-cli

CloudBase CLI (tcb, 云开发CLI, Tencent CloudBase命令行) resource management skill. Use when deploying cloud functions, CloudRun, storage, NoSQL/MySQL, static hosting, permissions, CORS/domains via tcb; for CI/CD and batch ops; when the user prefers CLI; or as the first-session fallback when CloudBase MCP tools are not loaded yet (after install/config, before IDE restart). Also covers tcb login and site switching (国内站/国际站 via --intl or config isIntl), environment lifecycle (env create/modify/renew/delete/apikey/login/domain), tcb config and cloudbaserc.json sync, log search (logs search, CLS), metric monitoring (monitor), data model and PostgreSQL migrations (db model, db pg migration), sandbox/agent/integration management — do not default to tcb deploy.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구PostgreSQLMySQL
설치 방법 보기

포함된 파일(21)

  • SKILL.md10.9 KB
  • LICENSE.md1.0 KB
  • references/access.md20.4 KB
  • references/agent.md4.4 KB
  • references/app.md10.9 KB
  • references/cloudrun.md16.6 KB
  • references/config.md11.9 KB
  • references/core.md28.8 KB
  • references/env.md12.7 KB
  • references/functions.md19.3 KB
  • references/hosting.md6.4 KB
  • references/integration.md5.0 KB
  • references/logs.md5.7 KB
  • references/lowcode.md4.2 KB
  • references/monitor.md4.8 KB
  • references/mysql.md9.8 KB
  • references/nosql.md10.1 KB
  • references/permission.md13.0 KB
  • references/sandbox.md6.2 KB
  • references/schema.md6.6 KB
  • references/storage.md13.5 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

CloudBase CLI

Manage CloudBase resources via tcb CLI — deterministic, scriptable, auditable. Primary interface for CI/CD and batch ops; also the first-session fallback when MCP tools are not yet available in the conversation.

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
  • MCP vs CLI fallback: ../cloudbase/references/tooling-fallback.md (packaged beside this skill as the cloudbase entry guideline)

Route, do not improvise — when a task belongs to another skill, hand over instead of guessing flags here:

  • PostgreSQL schema / RLS / pgstore → ../postgresql-development-cloudbase/SKILL.md
  • Data-model design (ER / Mermaid) → ../data-model-creation/SKILL.md
  • In-app SDK code (web / miniprogram / node) → the matching SDK skill

Core Principles

  1. --help first — but its failure does NOT mean the command is missing. Run tcb <command> --help to check parameters and find official doc links. On current CLI versions many second-level commands reject --help (error: unknown option '--help'), while some accept -h, and tcb help <cmd> only works one level deep. Try -h, then tcb help <cmd>, then tcb docs search "<keyword>" — never conclude a command does not exist from a help error. tcb --help itself is a hand-maintained static list, so absence from it says nothing about lifecycle: init, pull, new, open, rollback, self-update, monitor, integration, service, cloudfunction, cloudrunfunction and run:deprecated are all registered yet unlisted. Absence from help ≠ deprecated, and "no marker" ≠ endorsed — the statuses differ: tcb monitor / tcb integration are officially supported (recommend normally), while tcb service and tcb cloudfunction / tcb cloudrunfunction are not recommended (product decision, no code marker). Full status table: references/core.md.

  2. Confirm the site (国内站 / 国际站) as well as the envId. A credential from one site does not work on the other, and the failure looks like an auth error. One-off: tcb login --intl true|false; persistent: tcb config set isIntl true|false. Pick one mechanism and keep it consistent — see references/core.md / references/config.md.

  3. Deployment Gate. Before any deployment, publish, custom domain, or CloudRun operation, you must first complete the checks in cloudbase-platform/references/protocols/deployment-gate.md.

  4. Verify your work. After deploying or modifying any resource, run the corresponding list/detail command to confirm the change took effect.

  5. Dry-run before destructive actions. Use --dry-run for delete/overwrite operations. Show the preview to the user and wait for explicit confirmation before executing.

  6. Confirm environment first. Always verify envId with the user before operations. Run tcb env use <envId> to avoid accidentally modifying production.

  7. Recover from errors, don't loop. If a command fails after 2-3 attempts, check the exit code ($?), read the error message, consult tcb docs search, and try a different approach.

  8. First-session fallback, not MCP replacement. If CloudBase MCP tools are missing in this session, use this skill to unblock login/manage. Still configure MCP (plugin / mcp.json) so the next session can prefer MCP. When MCP tools are already available, prefer MCP unless the user asked for CLI/CI. Route deploy work through the domain reference table below — do not recommend tcb deploy.

  9. No npm/npx. If Node/npm/npx are missing, tell the user to install Node.js LTS (or use the IDE marketplace MCP path) before retrying CLI/plugin install. See guideline tooling-fallback.md.

When to use this skill

Use when the user wants to manage CloudBase resources via command line, or when MCP is not usable yet:

  • First session / post-install: MCP not in the tool list, or just configured and needs restart → tcb login + the matching domain command now; leave MCP ready for next session
  • Deploy/debug cloud functions, static hosting, CloudRun services (via domain refs — not tcb deploy)
  • Manage storage, hosting, databases (NoSQL / MySQL / PostgreSQL), data models and migrations
  • Manage environments (create / package / renew / destroy, API Keys, login policy, safe domains, usage)
  • Configure resource authorization (tcb policy), roles, users, CORS, domains, routing
  • Search logs and read monitoring metrics
  • Manage sandbox, agent and integration instances
  • CI/CD scripting, batch operations, terminal-based resource management
  • User explicitly prefers CLI over MCP

Do NOT use for

  • SDK-based in-app integration (web/miniprogram/node) → use cloud-functions, cloudbase-document-database-web-sdk, auth-web-cloudbase, etc.
  • PostgreSQL schema design, RLS and migration workflow → postgresql-development-cloudbase
  • When CloudBase MCP tools are already available in this session and the user did not ask for CLI → prefer MCP
  • Console UI operations
  • CloudBase Agent SDK development → use cloudbase-agent-ts

How to use this skill (for a coding agent)

  1. Always load references/core.md first — it covers authentication, site selection, environment switching, tcb docs queries, and error diagnosis.
  2. Route to the correct reference using the Routing table below.
  3. Load only the reference files that match the user's task. Do not preload all of them.
  4. Stop loading more context once you have the workflow and command syntax for the current task.
  5. If the task shifts to SDK/in-app code or PostgreSQL design, switch to the appropriate sibling skill instead.

Routing

User TaskRead
Login, site (国际站/国内站), env switching, tcb docs, error diagnosisreferences/core.md
Create / modify / renew / destroy an environment, API Keys, login policy, safe domains, usagereferences/env.md
tcb config (CLI settings, cloudbaserc.json sync), tcb init / new / pull / open / validate / self-update / rollbackreferences/config.md
Configure an AI tool + MCP + Skills (tcb ai)references/config.md
Deploy/debug cloud functions, versions, provisioned concurrency, layers, triggersreferences/functions.md
Deploy static site / SPA (preferred CLI web path)references/hosting.md
Deploy CloudRun service, traffic/canary, versions, build & runtime logsreferences/cloudrun.md
Experimental all-in-one web shorthand (tcb deploy, tcb app build) — avoid unless the user asksreferences/app.md
Upload/download files, ACL rules, COS vs PG object storagereferences/storage.md
NoSQL (MongoDB) database operations, collection dumpreferences/nosql.md
MySQL instance, SQL execution, backups, slow queriesreferences/mysql.md
Data model definitions, sync-model-dts, PostgreSQL migrationsreferences/schema.md
Search logs (CLS: functions / CloudRun / database / auth / LLM / gateway)references/logs.md
Metric monitoring (functions, CloudRun, DB, hosting, auth, gateway…)references/monitor.md
Resource authorization (tcb policy), roles, usersreferences/permission.md
CORS, custom domains, CDN cache purge, routing rules (tcb routes)references/access.md
tcb service (HTTP 访问服务) — ⚠️ not recommended; read access.md for the routes/domains equivalentreferences/access.md
WeDa / 微搭 low-code apps and components (tcb lowcode)references/lowcode.md
Sandbox tools / instances / API keysreferences/sandbox.md
Agent create / update / deletereferences/agent.md
Integration instances (types, create, bind, delete)references/integration.md
PostgreSQL schema / RLS / migration workflow (not just the CLI flags)../postgresql-development-cloudbase/SKILL.md

Quick workflow

  1. tcb login (check the site) → confirm envId with the user → tcb env use <envId>
  2. Look up the command in the matching reference; verify syntax with tcb <command> --help (or -h)
  3. Execute the command (with --dry-run for destructive ops)
  4. Verify the result with the corresponding list / detail command
  5. Report the outcome to the user

Minimum self-check

  • Loaded references/core.md before any domain module?
  • Confirmed the site (isIntl) and the target envId with the user?
  • Checked that --help failure was not misread as "command missing"?
  • Used --dry-run before destructive operations?
  • For PG environments: switched to the PostgreSQL skill instead of reusing NoSQL/MySQL paths?
  • Verified the result after each operation?
  • Stayed within CLI scope — did not drift into SDK code?

Reference index

All packaged reference files (required for skill lint reachability):

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Use this skill for Node.js backend AI via @cloudbase/node-sdk (>=3.16.0) — cloud functions, CloudRun, Express/Koa/NestJS, serverless APIs, scheduled jobs, LLM proxies, agent orchestration. The only SDK supporting image generation (ai.createImageModel + generateImage). Text via ai.createModel with groups cloudbase, hunyuan-exp, or custom-*; model ids (e.g. deepseek-v4-flash, glm-5, kimi-k2.6) go in the `model` field of generateText/streamText. MUST run two-step preflight before code — see body. NOT for browser/Web (use ai-model-web) or Mini Program (use ai-model-wechat).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

TencentCloudBase/CloudBase-AI-Toolkit1.1천2026년 10월 19일 업데이트

Use this skill when a browser/Web app (React, Vue, Next, Nuxt, static sites, SPAs, dashboards, AI chat UI, 页面, 前端, 网页) needs AI models via @cloudbase/js-sdk. Default routing for Web/frontend AI — call directly from the browser, do NOT propose a Node.js proxy. Covers generateText and streamText; models via ai.createModel with groups cloudbase, hunyuan-exp, or custom-*, model id in the `model` field. MUST run two-step preflight before code — see body. NOT for Node.js backend (use ai-model-nodejs), Mini Program (use ai-model-wechat), or image generation (Node SDK only).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

TencentCloudBase/CloudBase-AI-Toolkit1.1천2026년 10월 19일 업데이트

Use this skill for WeChat Mini Program AI via wx.cloud.extend.AI (小程序, wx.cloud apps). Covers generateText and streamText with callbacks (onText, onEvent, onFinish); streamText needs a data wrapper, generateText returns the raw response. Models via wx.cloud.extend.AI.createModel with groups hunyuan-exp (小程序成长计划), cloudbase (main managed), or custom-*; model id goes in the data wrapper `model` field. MUST run two-step preflight before code — see body. NOT for browser/Web (use ai-model-web), Node.js backend (use ai-model-nodejs), or image generation (use ai-model-nodejs).

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

TencentCloudBase/CloudBase-AI-Toolkit1.1천2026년 10월 19일 업데이트

Use when auditing CloudBase cloud API wrappers, MCP tools, generated action metadata, or related docs for outdated or incorrect action names, parameters, casing, request shapes, or missing contract tests, especially during periodic quality review or before preparing corrective PRs.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

TencentCloudBase/CloudBase-AI-Toolkit1.1천2026년 10월 19일 업데이트

CloudBase Node SDK auth guide for server-side identity, user lookup, and custom login tickets. This skill should be used when Node.js code must read caller identity, inspect end users, or bridge an existing user system into CloudBase; not when configuring providers or building client login UI.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

TencentCloudBase/CloudBase-AI-Toolkit1.1천2026년 10월 19일 업데이트

CloudBase auth provider configuration and login-readiness guide. This skill should be used when users need to inspect, enable, disable, or configure auth providers, publishable-key prerequisites, login methods, SMS/email sender setup, or other provider-side readiness before implementing a client or backend auth flow.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

TencentCloudBase/CloudBase-AI-Toolkit1.1천2026년 10월 19일 업데이트

TencentCloudBase의 스킬 모두 보기

이 스킬의 문제 신고