Menü
CSISP Supabase 开发/迁移 SOP。需要进行数据库结构变更、生成迁移、Dev 联调、Prod 发布或排查迁移不一致时调用。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
CSISP 前端 + BFF 开发 SOP。Invoke when developing frontend features (Portal, Idp Client, etc.) or BFF interfaces.
确认数据库调整内容后生成 Supabase 迁移文件。Invoke when user wants to create a database migration or has made database schema changes.
CSISP 后端微服务开发 SOP。Invoke when developing new microservices (Integrated Server, Idp Server, etc.) or adding features to existing services.
定义与创建 Supabase 数据库函数（RPC）的 SOP。遇到需要将写路径改造为 SECURITY DEFINER RPC 或需要在 Dashboard 创建/更新函数时调用。
撰写与维护文档项目（docs/）的统一 SOP 与 VitePress 写法。需要编写/重构文档或规范时调用。
| name | supabase-dev-workflow |
| description | CSISP Supabase 开发/迁移 SOP。需要进行数据库结构变更、生成迁移、Dev 联调、Prod 发布或排查迁移不一致时调用。 |
目标
先决条件
SUPABASE_URL_REFSUPABASE_ACCESS_TOKEN（Supabase PAT）关键目录与脚本
/supabase
migrations/ 所有迁移 SQL（唯一事实来源）config.toml CLI 配置README.md 本指南package.json 常用脚本/supabase 执行）
pnpm run login：CLI 登录（本机一次性）pnpm run link：链接项目（使用 SUPABASE_URL_REF）pnpm run db:pull：拉取远端结构pnpm run db:reset:dev：本地从 0 重放所有迁移，验证链路pnpm run migrations:list：比对本地文件与远端历史标准流程（本地 → Dev/Staging → Prod，在 supabase 目录下执行）
pnpm run loginpnpm run linkpnpm run db:pull（提示 Update history 选择 Y）supabase db diff 生成迁移文件pnpm run db:reset:dev 确保迁移链从 0 可完整重放supabase migration upmain 推送触发 Prod 工作流：supabase migration up迁移基线与一致性
db:pull 生成 remote_schema 基线，并在远端标记为 applied。db pullsupabase migration repair --status reverted <旧基线ID>，再对新基线 --status applied <新基线ID> → db pull/supabase 且已 link）：
pnpm run migrations:list：已封装好，直接运行infisical run --env=staging -- sh -lc 'supabase migration repair --status reverted <ID> --db-url "$DATABASE_URL"'infisical run --env=staging -- sh -lc 'supabase migration repair --status applied <ID> --db-url "$DATABASE_URL"'安全与规范