cloudbase-cli

CloudBase CLI

tcb CLI を使用して CloudBase リソースを管理します。決定論的で、スクリプト化でき、監査可能です。 CI/CD と一括操作の主要インターフェースです。MCP ツールがまだ会話で利用できない場合の初回セッションでの代替手段でもあります。

関連スキル（ローカルのみ）

関連する CloudBase スキルは、このスキルと一緒に提供されます。../auth-tool-cloudbase/SKILL.md のように、ローカルの相対パスを使用してください。

参照された関連スキルのファイルがこの環境にない場合は、CloudBase プラグイン一式（または不足しているスキル）のインストールをユーザーに依頼してください。リモートのスキルやプロトコルの Markdown を HTTP で取得してエージェントのコンテキストに読み込まないでください。

横断的なプロトコル（コード変更またはデプロイの前に必須）：

• 変更安全性プロトコル：../cloudbase-platform/references/protocols/change-safety-protocol.md
• デプロイゲート：../cloudbase-platform/references/protocols/deployment-gate.md
• MCP と CLI のフォールバック：../cloudbase/references/tooling-fallback.md（このスキルと並んで cloudbase エントリーガイドラインとして提供されています）

独自に判断せず、適切なスキルに引き継いでください — タスクが別のスキルに該当する場合は、ここでフラグを推測するのではなく、引き継いでください：

• PostgreSQL のスキーマ／RLS／pgstore → ../postgresql-development-cloudbase/SKILL.md
• データモデルの設計（ER／Mermaid） → ../data-model-creation/SKILL.md
• アプリ内 SDK コード（Web／ミニプログラム／Node） → 対応する SDK スキル

コア原則

1. まずは --help を確認します。ただし、エラーが出てもコマンドが存在しないとは限りません。 tcb <command> --help を実行して、パラメーターを確認し、公式ドキュメントへのリンクを探してください。現在の CLI バージョンでは、多くの 2 階層目のコマンドが --help を拒否します（error: unknown option '--help'）。一方、-h を受け付けるコマンドもあり、 tcb help <cmd> が機能するのは 1 階層目までです。まず -h を試し、次に tcb help <cmd>、その後 tcb docs search "<keyword>" を試してください。ヘルプのエラーだけを根拠に、コマンドが存在しないと判断してはいけません。 tcb --help 自体は手動で管理されている静的な一覧のため、一覧にないからといってライフサイクルについて何もわかりません。init、pull、new、open、rollback、self-update、monitor、integration、 service、cloudfunction、cloudrunfunction、run:deprecated は、いずれも登録されていますが一覧にはありません。 ヘルプにないこと ≠ 非推奨であり、「マーカーがない」≠ 推奨です。各コマンドのステータスは異なります。 tcb monitor ／ tcb integration は公式にサポートされているため、通常どおり推奨します。一方、 tcb service および tcb cloudfunction ／ tcb cloudrunfunction は、推奨されていません （製品上の決定であり、コード上のマーカーはありません）。ステータスの一覧は references/core.md を参照してください。

2. envId とともに、サイト（国内サイト／国際サイト）も確認してください。 片方のサイトの認証情報はもう一方では使えず、認証エラーのようなエラーが発生します。 1 回限りの設定：tcb login --intl true|false。永続的な設定：tcb config set isIntl true|false。 いずれか一方の方法を選び、一貫して使ってください。詳しくは references/core.md ／ references/config.md を参照してください。

3. デプロイゲート。 デプロイ、公開、カスタムドメインの設定、CloudRun の操作を行う前に、必ず cloudbase-platform/references/protocols/deployment-gate.md のチェックを完了してください。

4. 作業を検証してください。 デプロイ後、またはリソースの変更後は、対応する一覧表示／詳細表示コマンドを実行し、変更が反映されたことを確認してください。

5. 破壊的な操作の前にドライランを実行してください。 削除／上書き操作では --dry-run を使用してください。プレビューをユーザーに提示し、明示的な確認を得てから実行してください。

6. まず環境を確認してください。 操作の前に、必ずユーザーに envId を確認してください。本番環境を誤って変更しないよう、tcb env use <envId> を実行してください。

7. エラーから復旧し、同じ試行を繰り返さないでください。 コマンドが 2～3 回試しても失敗する場合は、終了コード（$?）を確認し、エラーメッセージを読み、tcb docs search を参照して、別の方法を試してください。

8. 初回セッションでのフォールバックであり、MCP の代替ではありません。 このセッションで CloudBase MCP ツールを使えない場合は、このスキルを使ってログインや管理を行ってください。それでも、次のセッションで MCP を優先できるよう、MCP（プラグイン／mcp.json）を設定してください。MCP ツールがすでに使える場合は、ユーザーが CLI／CI を指定していない限り、MCP を優先してください。デプロイ作業は、以下のドメイン参照表に従ってください。tcb deploy は推奨しないでください。

9. npm／npx は使わないでください。 Node／npm／npx がない場合は、CLI／プラグインのインストールを再試行する前に、Node.js LTS をインストールするか、IDE のマーケットプレイスから MCP を使うようユーザーに伝えてください。ガイドライン tooling-fallback.md を参照してください。

このスキルを使用する場合

ユーザーがコマンドラインで CloudBase リソースを管理したい場合、または MCP がまだ使用できない場合に使用します。

• 初回セッション／インストール後： MCP がツール一覧にない、または設定したばかりで再起動が必要な場合 → tcb login と対応するドメインコマンドを今すぐ実行し、次のセッションに備えて MCP を利用可能な状態にします
• クラウド関数、静的ホスティング、CloudRun サービスをデプロイ／デバッグする（ドメイン参照を使用し、tcb deploy は使用しない）
• ストレージ、ホスティング、データベース（NoSQL／MySQL／PostgreSQL）、データモデル、マイグレーションを管理する
• 環境を管理する（作成／パッケージ化／更新／破棄、API Keys、ログインポリシー、安全なドメイン、使用状況）
• リソースの認可（tcb policy）、ロール、ユーザー、CORS、ドメイン、ルーティングを設定する
• ログを検索し、監視メトリクスを読み取る
• サンドボックス、エージェント、インテグレーションのインスタンスを管理する
• CI/CD スクリプト作成、一括操作、ターミナルベースのリソース管理
• ユーザーが MCP より CLI を明示的に希望している場合

使用しないでください

• SDK ベースのアプリ内統合（web/miniprogram/node）→ cloud-functions、 cloudbase-document-database-web-sdk、auth-web-cloudbase などを使用してください。
• PostgreSQL のスキーマ設計、RLS、マイグレーションのワークフロー → postgresql-development-cloudbase
• このセッションですでに CloudBase MCP ツールを利用でき、ユーザーが CLI を求めていない場合 → MCP を優先してください。
• コンソール UI 操作
• CloudBase Agent SDK の開発 → cloudbase-agent-ts を使用してください。

このスキルの使い方（コーディングエージェント向け）

1. 必ず最初に references/core.md を読み込んでください — 認証、サイトの選択、環境の切り替え、tcb docs によるクエリ、エラー診断について説明しています。
2. 以下のルーティング表を使って適切なリファレンスを選んでください。
3. ユーザーのタスクに該当するリファレンスファイルだけを読み込んでください。 すべてのファイルを事前に読み込まないでください。
4. 現在のタスクに必要なワークフローとコマンド構文が把握できたら、追加のコンテキストの読み込みを停止してください。
5. **タスクが SDK／アプリ内コードまたは PostgreSQL の設計に移った場合は、**適切な関連スキルに切り替えてください。

ルーティング

ユーザーのタスク	読み込むファイル
ログイン、サイト（国际站/国内站）、環境の切り替え、tcb docs、エラー診断	references/core.md
環境の作成／変更／更新／削除、API Keys、ログインポリシー、安全なドメイン、使用状況	references/env.md
tcb config（CLI 設定、cloudbaserc.json の同期）、tcb init / new / pull / open / validate / self-update / rollback	references/config.md
AI ツール + MCP + Skills の設定（tcb ai）	references/config.md
クラウド関数、バージョン、プロビジョニング済み同時実行、レイヤー、トリガーのデプロイ／デバッグ	references/functions.md
静的サイト／SPA のデプロイ（推奨される CLI の Web パス）	references/hosting.md
CloudRun サービス、トラフィック／カナリア、バージョン、ビルドおよびランタイムログのデプロイ	references/cloudrun.md
実験的なオールインワン Web の簡略コマンド（tcb deploy、tcb app build）— ユーザーから求められない限り使用しないでください	references/app.md
ファイルのアップロード／ダウンロード、ACL ルール、COS と PG オブジェクトストレージ	references/storage.md
NoSQL（MongoDB）データベース操作、コレクションのダンプ	references/nosql.md
MySQL インスタンス、SQL の実行、バックアップ、スロークエリ	references/mysql.md
データモデル定義、sync-model-dts、PostgreSQL のマイグレーション	references/schema.md
ログの検索（CLS：関数／CloudRun／データベース／認証／LLM／ゲートウェイ）	references/logs.md
メトリクス監視（関数、CloudRun、DB、ホスティング、認証、ゲートウェイなど）	references/monitor.md
リソースの認可（tcb policy）、ロール、ユーザー	references/permission.md
CORS、カスタムドメイン、CDN キャッシュのパージ、ルーティングルール（tcb routes）	references/access.md
tcb service（HTTP 访问服务）— ⚠️ 非推奨です。routes／domains に相当する設定については access.md を参照してください。	references/access.md
WeDa / 微搭 のローコードアプリとコンポーネント（tcb lowcode）	references/lowcode.md
サンドボックスのツール／インスタンス／API キー	references/sandbox.md
エージェントの作成／更新／削除	references/agent.md
統合インスタンス（種類、作成、バインド、削除）	references/integration.md
PostgreSQL のスキーマ／RLS／マイグレーションのワークフロー（CLI フラグだけではない場合）	../postgresql-development-cloudbase/SKILL.md

クイックワークフロー

1. tcb login（サイトを確認）→ ユーザーに envId を確認 → tcb env use <envId>
2. 該当するリファレンスでコマンドを調べ、tcb <command> --help（または -h）で構文を確認
3. コマンドを実行（破壊的操作では --dry-run を使用）
4. 対応する list／detail コマンドで結果を確認
5. ユーザーに結果を報告

最低限のセルフチェック

• ドメインモジュールを使用する前に、references/core.md を読み込みましたか？
• サイト（isIntl）と対象の envId をユーザーに確認しましたか？
• --help の失敗を「コマンドが見つからない」と誤解していないことを確認しましたか？
• 破壊的な操作の前に --dry-run を使用しましたか？
• PG 環境の場合、NoSQL／MySQL の手順を流用せず、PostgreSQL スキルに切り替えましたか？
• 各操作の後に結果を確認しましたか？
• CLI の範囲内にとどまり、SDK のコードに逸脱していませんか？

リファレンス一覧

パッケージに含まれるすべてのリファレンスファイル（スキルのリントで参照可能にするために必須）：

• access.md
• agent.md
• app.md
• cloudrun.md
• config.md
• core.md
• env.md
• functions.md
• hosting.md
• integration.md
• logs.md
• lowcode.md
• monitor.md
• mysql.md
• nosql.md
• permission.md
• sandbox.md
• schema.md
• storage.md