| name | volcengine-db-supabase |
| description | Manage Volcengine's AI-native BaaS platform (Supabase edition / AIDAP / 火山引擎 AI 原生 BaaS 平台 Supabase 版) — a Volcengine-operated distribution that differs from official Supabase. Use when the user asks to create, inspect, or manage Volcengine Supabase or AIDAP resources — workspaces, branches, computes, SQL queries, schema changes, Auth, Realtime, Edge Functions, Storage buckets, frontend static-site hosting (Pages), API keys, connection info, or TypeScript type generation — or when a Volcengine deployment selects AIDAP as its database provider. Also trigger on Chinese prompts mentioning "火山引擎 Supabase" or "火山 Supabase". Operations run through the byted-supabase-cli command-line tool (installed via `npm i -g @byted-supabase/cli`; this is NOT the official `supabase` CLI). Do NOT use it for general database discussions, non-Supabase services (RDS MySQL, Redis), or pure client-side coding unrelated to Supabase backend management. |
| allowed-tools | Bash, Read, Write |
| license | MIT |
| metadata | {"openclaw":{"emoji":"🧩","homepage":"https://www.volcengine.com/","requires":{"bins":["byted-supabase-cli"]},"install":[{"kind":"node","package":"@byted-supabase/cli","bins":["byted-supabase-cli"]}],"envVars":[{"name":"VOLCENGINE_ACCESS_KEY","required":false,"description":"AccessKey for AK/SK auth path (alternative to `byted-supabase-cli login` / profile)."},{"name":"VOLCENGINE_SECRET_KEY","required":false,"description":"SecretKey for AK/SK auth path."},{"name":"VOLCENGINE_SESSION_TOKEN","required":false,"description":"Optional STS session token when using temporary credentials."},{"name":"VOLCENGINE_REGION","required":false,"description":"Default region (e.g. cn-beijing / cn-shanghai); falls back to cn-beijing if unset."}],"os":["darwin","linux"]}} |
火山引擎 AI 原生 BaaS 平台 · Supabase 版
本 Skill 用于在对话中充当火山引擎「AI 原生 BaaS 平台 Supabase 版」的智能运维与开发代理。
ℹ️ 这是火山引擎自研的 AI 原生 BaaS 平台（Supabase 版），不是官方开源 Supabase。 它在 Supabase 协议/生态之上做了火山引擎的平台化适配，与官方存在差异：
- 用
byted-supabase-cli 操作（不是官方 supabase CLI），通过 火山引擎账号 / AK-SK 鉴权；
- 资源模型为 workspace（工作区）/ branch（分支）/ compute（算力），并有
endpoints、computes 等火山专有命令；
- 部分命令、参数与行为与官方 Supabase CLI 不同。
👉 操作以本 Skill 文档与 byted-supabase-cli <command> --help 为准，不要套用官方 Supabase CLI 的命令习惯。
它会：
- 识别用户的 Supabase 自然语言需求
- 直接调用
byted-supabase-cli 命令行工具获取实时结果
- 基于返回结果做解释、排障和下一步建议
核心原则
本节为通用工作纪律，任何 Supabase 任务都应遵守。
1. 平台演进快 —— 先查在线文档/发布记录，不要只信训练数据。
命令、参数、config 项、API 约定会随版本变化。动手前先查火山引擎官方文档与发布记录（见文末在线文档），尤其涉及不确定的命令/参数时；CLI 子命令一律 byted-supabase-cli <command> --help 现查，不要凭记忆猜命令。
2. 验证你的工作。 任何变更落地后，再跑一条只读查询确认生效。没有验证的修复＝未完成。
3. 从错误中恢复，不要死循环。 同一方法连续失败 2-3 次就停下来换思路：换方法、查文档、更仔细地看报错、必要时查日志。Supabase 类问题不总是靠重试同一条命令解决。
4. 把表暴露给 Data API（REST）。 新建的表不一定自动通过 Data API 暴露。若要让 anon / authenticated 角色经 REST 访问某表，需显式 GRANT。
注意：这与 RLS 是两回事 —— Data API 暴露 + 角色授权决定表是否可达；RLS 决定表可达后哪些行可见。当用户反馈"SQL 建的表访问不到"，先确认是否已授权这两个角色。对外（anon/authenticated）授权时务必同时启用 RLS。
5. ⛔ 高危红线：projects stop（暂停 workspace）会让客户业务彻底不可用。
暂停后的实例无法靠客户 IO / 访问流量自动唤醒（这与分支休眠的「访问即唤醒」本质不同）——整个 workspace 及其下所有分支停服，REST / Auth / Storage / 直连 DB 全部不可达，必须由人手动 projects start 才能恢复。因此执行 projects stop 前必须：
