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
--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.
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.
Verify your work.
After deploying or modifying any resource, run the corresponding list/detail
command to confirm the change took effect.
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.
Confirm environment first.
Always verify envId with the user before operations. Run tcb env use <envId>
to avoid accidentally modifying production.
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.
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.
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)
- Always load
references/core.md first — it covers authentication,
environment switching, tcb docs queries, and error diagnosis.
- Route to the correct domain reference using the Routing table below.
- Load only the one reference file that matches the user's task.
Do not preload all references.
- Stop loading more context once you have the workflow and command
syntax for the current task.
- 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 Task |
Read |
| Login, env switching, tcb docs, error diagnosis |
references/core.md |
| Deploy/debug cloud functions |
references/functions.md |
| Deploy static site / SPA (preferred CLI web path) |
references/hosting.md |
| Deploy CloudRun service |
references/cloudrun.md |
Experimental all-in-one web shorthand (tcb deploy) — avoid unless user explicitly asks |
references/app.md |
| Upload/download files, ACL rules |
references/storage.md |
| NoSQL (MongoDB) database operations |
references/nosql.md |
| MySQL database operations |
references/mysql.md |
| Roles, policies, access control |
references/permission.md |
| CORS, custom domains, routing rules |
references/access.md |
Quick workflow
tcb login → confirm envId with user → tcb env use <envId>
tcb <command> --help to verify syntax
- Execute the command (with
--dry-run for destructive ops)
- Verify the result with the corresponding
list / detail command
- Report the outcome to the user
Minimum self-check
Reference index
All packaged reference files (required for skill lint reachability):
- access.md
- app.md
- cloudrun.md
- core.md
- functions.md
- hosting.md
- mysql.md
- nosql.md
- permission.md
- storage.md
1---
2name: cloudbase-cli
3description: 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.
4version: 2.32.5
5alwaysApply: false
6metadata:
7 source: https://skillmd.com/skills/ahang1598/cloudbase-cli
8---
9
10# CloudBase CLI
11
12Manage CloudBase resources via `tcb` CLI — deterministic, scriptable, auditable.
13Primary interface for CI/CD and batch ops; **also the first-session fallback** when MCP tools are not yet available in the conversation.
14
15## Sibling skills (local only)
16
17Sibling CloudBase skills ship beside this skill. Use local relative paths such as `../auth-tool-cloudbase/SKILL.md`.
18
19If 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.
20
21**Cross-cutting protocols** (required before code changes or deployments):
22- Change Safety Protocol: `../cloudbase-platform/references/protocols/change-safety-protocol.md`
23- Deployment Gate: `../cloudbase-platform/references/protocols/deployment-gate.md`
24- MCP vs CLI fallback: `../cloudbase/references/tooling-fallback.md` (packaged beside this skill as the `cloudbase` entry guideline)
25
26## Core Principles
27
281. **`--help` first — never guess commands.**
29 tcb CLI changes between versions. Before using any command for the first time,
30 run `tcb <command> --help` to check parameters and discover official doc links.
31
322. **Deployment Gate.**
33 Before any deployment, publish, custom domain, or CloudRun operation, you must first complete the checks in `cloudbase-platform/references/protocols/deployment-gate.md`.
34
353. **Verify your work.**
36 After deploying or modifying any resource, run the corresponding list/detail
37 command to confirm the change took effect.
38
393. **Dry-run before destructive actions.**
40 Use `--dry-run` for delete/overwrite operations. Show the preview to the user
41 and wait for explicit confirmation before executing.
42
434. **Confirm environment first.**
44 Always verify envId with the user before operations. Run `tcb env use <envId>`
45 to avoid accidentally modifying production.
46
475. **Recover from errors, don't loop.**
48 If a command fails after 2-3 attempts, check the exit code (`$?`), read the
49 error message, consult `tcb docs search`, and try a different approach.
50
516. **First-session fallback, not MCP replacement.**
52 If CloudBase MCP tools are missing in this session, use this skill to unblock
53 login/manage. Still configure MCP (plugin / mcp.json) so the **next** session
54 can prefer MCP. When MCP tools are already available, prefer MCP unless the
55 user asked for CLI/CI. Route deploy work through the domain reference table
56 below — **do not** recommend `tcb deploy`.
57
587. **No npm/npx.**
59 If Node/npm/npx are missing, tell the user to install Node.js LTS (or use the
60 IDE marketplace MCP path) before retrying CLI/plugin install. See guideline
61 `tooling-fallback.md`.
62
63## When to use this skill
64
65Use when the user wants to manage CloudBase resources via command line, **or** when MCP is not usable yet:
66- **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
67- Deploy/debug cloud functions, static hosting, CloudRun services (via domain refs — not `tcb deploy`)
68- Manage storage, hosting, databases (NoSQL/MySQL)
69- Configure permissions, CORS, domains, routing
70- CI/CD scripting, batch operations, terminal-based resource management
71- User explicitly prefers CLI over MCP
72
73## Do NOT use for
74
75- SDK-based in-app integration (web/miniprogram/node) → use `cloud-functions`,
76 `cloudbase-document-database-web-sdk`, `auth-web-cloudbase`, etc.
77- When CloudBase MCP tools are already available in this session and the user did not ask for CLI → prefer MCP
78- Console UI operations
79- CloudBase Agent SDK development → use `cloudbase-agent-ts`
80
81## How to use this skill (for a coding agent)
82
831. **Always load `references/core.md` first** — it covers authentication,
84 environment switching, `tcb docs` queries, and error diagnosis.
852. **Route to the correct domain reference** using the Routing table below.
863. **Load only the one reference file** that matches the user's task.
87 Do not preload all references.
884. **Stop loading more context** once you have the workflow and command
89 syntax for the current task.
905. **If the task shifts to SDK/in-app code**, switch to the appropriate
91 SDK skill (e.g., `cloud-functions`, `cloudbase-document-database-web-sdk`) instead.
92
93## Routing
94
95| User Task | Read |
96|-----------|------|
97| Login, env switching, tcb docs, error diagnosis | `references/core.md` |
98| Deploy/debug cloud functions | `references/functions.md` |
99| Deploy static site / SPA (preferred CLI web path) | `references/hosting.md` |
100| Deploy CloudRun service | `references/cloudrun.md` |
101| Experimental all-in-one web shorthand (`tcb deploy`) — avoid unless user explicitly asks | `references/app.md` |
102| Upload/download files, ACL rules | `references/storage.md` |
103| NoSQL (MongoDB) database operations | `references/nosql.md` |
104| MySQL database operations | `references/mysql.md` |
105| Roles, policies, access control | `references/permission.md` |
106| CORS, custom domains, routing rules | `references/access.md` |
107
108## Quick workflow
109
1101. `tcb login` → confirm envId with user → `tcb env use <envId>`
1112. `tcb <command> --help` to verify syntax
1123. Execute the command (with `--dry-run` for destructive ops)
1134. Verify the result with the corresponding `list` / `detail` command
1145. Report the outcome to the user
115
116## Minimum self-check
117
118- [ ] Loaded `references/core.md` before any domain module?
119- [ ] Confirmed target envId with the user?
120- [ ] Used `--help` for unfamiliar commands?
121- [ ] Used `--dry-run` before destructive operations?
122- [ ] Verified the result after each operation?
123- [ ] Stayed within CLI scope — did not drift into SDK code?
124
125## Reference index
126
127All packaged reference files (required for skill lint reachability):
128
129- [access.md](references/access.md)
130- [app.md](references/app.md)
131- [cloudrun.md](references/cloudrun.md)
132- [core.md](references/core.md)
133- [functions.md](references/functions.md)
134- [hosting.md](references/hosting.md)
135- [mysql.md](references/mysql.md)
136- [nosql.md](references/nosql.md)
137- [permission.md](references/permission.md)
138- [storage.md](references/storage.md)