闲社服务运行正常AI智能体自动化平台
b

火山引擎Supabase管理

技能标识:byted-supabase

Manage Volcengine Supabase workspaces, branches, SQL queries, migrations, Edge Functions, Storage, and TypeScript type generation via a local CLI. Run uv run ./scripts/call_volcengine_supabase.py to get real-time results. Use this skill when the user needs to create, inspect, or manage Volcengine Supabase resources (workspaces, databases, branches, Edge Functions, Storage, API keys, or type generation). Do NOT use it for general database discussions, non-Supabase services, or pure client-side co

作者:admin | 来源记录:ClawHub
登记来源
ClawHub
版本
V 1.0.0
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息,并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限,建议先在隔离环境中运行。
概述
安装方式
版本历史

火山引擎Supabase管理

火山引擎 Supabase

本 Skill 用于在对话中充当火山引擎 Supabase 的智能运维与开发代理。

它会:

  • - 识别用户的 Supabase 自然语言需求
  • 直接调用 scripts/callvolcenginesupabase.py 获取实时结果
  • 基于返回结果做解释、排障和下一步建议

何时使用本 Skill

适用场景(应使用):

  • - 用户提到 Supabase、火山引擎 Supabase 相关的操作需求
  • 需要创建、查看、暂停或恢复 Supabase 工作区(workspace)
  • 需要对 Supabase 数据库执行 SQL 查询、建表、迁移
  • 需要管理 Supabase 分支(创建、删除、重置)
  • 需要部署或管理 Edge Functions
  • 需要操作 Storage Bucket(创建、删除、查看配置)
  • 需要获取 Supabase 项目的 API Key 或 连接信息
  • 需要为 Supabase 数据库 生成 TypeScript 类型定义

不适用场景(无需使用):

  • - 仅讨论通用数据库概念,不涉及火山引擎 Supabase 实例
  • 操作非 Supabase 的数据库服务(如 RDS MySQL、Redis)
  • 纯前端 / 客户端代码编写,不涉及 Supabase 后端资源管理
  • 用户只是询问 Supabase 文档 / 概念,无需调用 CLI

运行方式

bash

方式 1:使用 uv(推荐)


uv run ./scripts/callvolcenginesupabase.py [options]

方式 2:使用 python(需预装依赖)

python ./scripts/callvolcenginesupabase.py [options]

前置条件

  • - 必需环境变量:VOLCENGINEACCESSKEY、VOLCENGINESECRETKEY(如果在沙箱环境/vefaas IAM 环境下运行,将自动获取临时凭证,可不配置环境变量)
  • 可选环境变量:VOLCENGINEREGION、DEFAULTWORKSPACEID、READONLY、SUPABASEWORKSPACESLUG、SUPABASEENDPOINTSCHEME
  • 若未配置依赖,可先执行:uv pip install -r requirements.txt 或 pip install -r requirements.txt

标准使用流程

  1. 1. 先确认目标资源:workspaceid 或 branchid
  2. 优先执行只读查询,确认现状
  3. 需要变更时,再执行写操作
  4. 变更后再次查询,确认结果已生效

常用命令示例

bash

查看可访问的 workspace


uv run ./scripts/callvolcenginesupabase.py list-workspaces

查看 workspace 详情

uv run ./scripts/callvolcenginesupabase.py describe-workspace --workspace-id ws-xxxx

获取 workspace URL

uv run ./scripts/callvolcenginesupabase.py get-workspace-url --workspace-id ws-xxxx

查看分支

uv run ./scripts/callvolcenginesupabase.py list-branches --workspace-id ws-xxxx

执行 SQL

uv run ./scripts/callvolcenginesupabase.py execute-sql --workspace-id ws-xxxx --query SELECT * FROM pg_tables LIMIT 5

从文件执行 migration

uv run ./scripts/callvolcenginesupabase.py apply-migration --workspace-id ws-xxxx --name createtodostable --query-file ./migration.sql

部署 Edge Function

uv run ./scripts/callvolcenginesupabase.py deploy-edge-function --workspace-id ws-xxxx --function-name hello --source-file ./index.ts

创建 Storage bucket

uv run ./scripts/callvolcenginesupabase.py create-storage-bucket --workspace-id ws-xxxx --bucket-name uploads --public

能力范围

工作区与分支

  • - list-workspaces
  • describe-workspace
  • create-workspace
  • pause-workspace
  • restore-workspace
  • get-workspace-url
  • get-keys
  • list-branches
  • create-branch
  • delete-branch
  • reset-branch

数据库

  • - execute-sql
  • list-tables
  • list-migrations
  • list-extensions
  • apply-migration
  • generate-typescript-types

Edge Functions / Storage

  • - list-edge-functions
  • get-edge-function
  • deploy-edge-function
  • delete-edge-function
  • list-storage-buckets
  • create-storage-bucket
  • delete-storage-bucket
  • get-storage-config

应用开发参考

在使用本 Skill 管理 Supabase 资源的同时,以下文档提供应用开发场景的指导:

需求文档
将 Supabase 接入 TS/Python 应用(SDK 初始化 + CRUD)references/app-integration-guide.md
数据库表结构设计与迁移规范
references/schema-guide.md |
| 行级安全策略(RLS)配置 | references/rls-guide.md |
| Edge Function 编写与部署 | references/edge-function-dev-guide.md |

💡 典型工作流:先用 CLI 创建 workspace / 建表 / 配置 RLS,再参考应用开发文档在业务代码中集成 Supabase SDK。

注意事项

  • - 默认遵循先查后改
  • get-keys 默认脱敏,只有明确需要时才加 --reveal
  • reset-branch 会丢失未追踪变更,且后端当前会忽略 migrationversion
  • READONLY=true 时,所有写操作会被拒绝

参考资料

  • - 工具说明:references/tool-reference.md
  • 操作流程:references/workflows.md
  • SQL 示例:references/sql-playbook.md
  • 应用集成:references/app-integration-guide.md
  • Schema 设计:references/schema-guide.md
  • RLS 策略:references/rls-guide.md
  • Edge Function 开发:references/edge-function-dev-guide.md

标签

skill ai

通过对话安装

以下为平台配置的接入选项,并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 byted-supabase-1775986096 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 byted-supabase-1775986096 技能

通过命令行安装

skillhub install byted-supabase-1775986096

下载

⬇ 下载 byted-supabase v1.0.0(免费)

文件大小: 51.95 KB | 发布时间: 2026-4-13 09:37

v1.0.0 最新 2026-4-13 09:37
Initial release of byted-supabase:

- Provides CLI management for Volcengine Supabase workspaces, branches, SQL, migrations, Edge Functions, Storage, and TypeScript type generation.
- Uses ./scripts/call_volcengine_supabase.py to handle real-time tasks via uv or Python CLI.
- Includes detailed usage scopes, workflows, command examples, and environment variable guidance.
- Covers both typical backend management scenarios and integration with application development documentation.
- Restricts scope to Supabase resource management; not for generic database operations or unrelated frontend tasks.
返回顶部