用途:该技能用于通过 Supabase MCP 工具对 Supabase 数据库执行操作,包括查询与统计、导出、写入、迁移(DDL)、类型生成以及查询日志与顾问建议。它只处理数据库侧动作与安全门禁,不负责 Next.js 项目侧的集成实现(如环境变量、客户端代码、数据访问层与项目结构),后者应使用 workflow-ship-faster 的 Supabase 集成步骤。
主要能力:提供 list_tables、execute_sql、apply_migration、list_migrations、generate_typescript_types、get_project_url、get_publishable_keys、get_logs、get_advisors 等工具;可选启用 Edge Functions 与分支相关工具。内置 Supabase Postgres 最佳实践参考,位于 supabase/references/postgres-best-practices/AGENTS.md 及 rules/*.md,用于编写、审查和优化 SQL、设计索引与 RLS 策略、诊断性能与锁问题,提出变更时应引用对应规则文件路径并保持最小改动。
使用方式:先解析需求并复述目标;不确定表或字段时先用 list_tables 或查询 information_schema;规划 SQL 并展示给用户;只读操作直接执行;写入操作需先展示 SQL、说明预期影响行数并等待明确确认,执行后核对影响行数并报告结果。所有 SELECT 默认 LIMIT 50,除非用户明确要求更多。INSERT/UPDATE/DELETE 必须确认;无 WHERE 的 UPDATE/DELETE 直接拒绝;影响超过 100 行需二次确认并建议先 SELECT count(*)。DDL 必须通过 apply_migration,execute_sql 不能直接运行 DDL。生产环境默认禁用写入,仅在用户明确要求并在生产执行且二次确认时允许。email、phone、token、password 等敏感字段默认脱敏或不返回。
适用场景:Supabase 数据库的查询与统计、导出、写入、迁移、类型生成、日志与顾问诊断,以及作为多步骤工作流的数据库操作基础。文件式流水线建议将上下文与产物落盘,仅传递路径,目录如 runs/<workflow>/active/<run_id>/,包含输入、计划、输出与日志。
限制:不适用于项目侧集成实现;输出语言为英文;结果表最多 50 行,超出需截断并显示总数或分页导出;项目专属 schema.md 可能过时,应以 information_schema 或 generate_typescript_types 为准。错误处理涵盖 SQL 语法错误、权限不足、无数据返回与 RLS 拦截等情况。