用途:在 Supabase 上执行数据库侧操作,包括查询/统计/导出、写入(需确认)、迁移(DDL)、类型生成,以及查询日志与顾问诊断。不负责项目侧集成(环境变量、客户端代码、数据访问层),那部分由 workflow-ship-faster 处理;本技能是其数据库操作基础。
主要能力:内置 Supabase 的 Postgres 最佳实践,位于 references/postgres-best-practices/,完整指南见 AGENTS.md,单条规则见 rules/*.md,提出变更时应引用对应规则文件路径并保持最小改动。执行后端可选:MCP(自动)、Supabase CLI、psql 或 Dashboard,详见 BACKENDS.md;MCP 配置见 SETUP.md。
安全规则:操作前先查 schema;SELECT 默认 LIMIT 50,除非用户明确要求更多;INSERT/UPDATE/DELETE 执行前须展示 SQL、说明预计影响行数并等待明确确认;无 WHERE 的 UPDATE/DELETE 直接拒绝;影响超过 100 行需二次确认并建议先 SELECT count(*);schema 变更必须走迁移而非直接 DDL;生产环境默认禁用写入,仅当用户明确要求并在二次确认后允许;email/phone/token/password 等敏感字段默认脱敏或不返回。
使用方式:解析需求并复述目标;不确定表/字段时先查 information_schema 或 list_tables;给出 SQL 计划;只读直接执行,写入先确认再执行并核对影响行数后报告。多步工作流可将产物落盘到 runs/<workflow>/active/<run_id>/,含 proposal.md、context.json、tasks.md、evidence/sql.md、evidence/result.md、logs/events.jsonl。输出为英文,结构为结论→关键数字→执行的 SQL→结果表(最多 50 行),溢出时截断并显示总数。
适用场景:按天统计注册用户、查找有运行记录但全部失败的项目、插入/更新/删除记录、schema 发现等。限制:不处理项目侧集成;生产写入默认关闭;无 WHERE 写入被拒;具体项目 schema 参考 schema.md,可能过时。