本文へ移動
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). Covers tcb login (device code for Tencent Cloud accounts; --cloudbase-api-key -e for environment API Key without an account; --apiKeyId/--apiKey for CI) and domain commands (fn/hosting/cloudrun/…) as MCP auth/manage parity — do not default to tcb deploy.

TencentCloudBase/CloudBase-AI-Toolkit
インストール方法を見る

含まれるファイル（12）

  • SKILL.md6.8 KB
  • LICENSE.md1.0 KB
  • references/access.md8.9 KB
  • references/app.md9.1 KB
  • references/cloudrun.md9.6 KB
  • references/core.md18.5 KB
  • references/functions.md13.0 KB
  • references/hosting.md6.0 KB
  • references/mysql.md9.1 KB
  • references/nosql.md9.4 KB
  • references/permission.md11.0 KB
  • references/storage.md10.3 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)

Core Principles

  1. --help first — never guess commands. tcb CLI changes between versions. Before using any command for the first time, run tcb <command> --help to check parameters and discover official doc links.

  2. 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.

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

  4. 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.

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

  6. 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.

  7. 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.

  8. 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)
  • Configure permissions, CORS, domains, routing
  • 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.
  • 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, environment switching, tcb docs queries, and error diagnosis.
  2. Route to the correct domain reference using the Routing table below.
  3. Load only the one reference file that matches the user's task. Do not preload all references.
  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, switch to the appropriate SDK skill (e.g., cloud-functions, cloudbase-document-database-web-sdk) instead.

Routing

User TaskRead
Login, env switching, tcb docs, error diagnosisreferences/core.md
Deploy/debug cloud functionsreferences/functions.md
Deploy static site / SPA (preferred CLI web path)references/hosting.md
Deploy CloudRun servicereferences/cloudrun.md
Experimental all-in-one web shorthand (tcb deploy) — avoid unless user explicitly asksreferences/app.md
Upload/download files, ACL rulesreferences/storage.md
NoSQL (MongoDB) database operationsreferences/nosql.md
MySQL database operationsreferences/mysql.md
Roles, policies, access controlreferences/permission.md
CORS, custom domains, routing rulesreferences/access.md

Quick workflow

  1. tcb login → confirm envId with user → tcb env use <envId>
  2. tcb <command> --help to verify syntax
  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 target envId with the user?
  • Used --help for unfamiliar commands?
  • Used --dry-run before destructive operations?
  • 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):

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

ai-model-nodejs

無料

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,1362026年10月11日 更新

ai-model-web

無料

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,1362026年10月11日 更新

ai-model-wechat

無料

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,1362026年10月11日 更新

api-contract-review

無料

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,1362026年10月11日 更新

auth-nodejs-cloudbase

無料

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,1362026年10月11日 更新

auth-tool-cloudbase

無料

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,1362026年10月11日 更新

TencentCloudBase のスキルをすべて見る

このスキルの問題を報告する