SuperAPI AI 工具集

schema-validation

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:在部署前对 Supabase/PostgreSQL 项目的数据库架构进行校验,涵盖 SQL 语法、命名规范、约束、索引和 RLS 策略,降低无效架构上线风险。

主要能力:可用完整校验脚本传入单个架构文件或目录;也可分别执行单项校验脚本,包括 SQL 语法(PostgreSQL 语法合规、保留字、语句结束、数据类型)、命名规范(snake_case、表名复数、列名单数、fk_/uq_/ck_/pk_、idx_/uidx_)、约束(主键存在、外键引用、唯一约束、检查约束、NOT NULL)、索引(外键和 RLS 列覆盖、重复索引、命名)以及 RLS(公共表启用 RLS、CRUD 策略、角色指定、性能优化)。完整校验会生成 Markdown 报告,按 ERROR、WARNING、INFO 分级列出问题与建议,并含统计摘要。规则可通过 templates/validation-rules.json 与 templates/naming-conventions.json 自定义。

使用方式:进入项目目录后运行全量校验:bash <路径>/scripts/full-validation.sh <schema-file-or-directory>。单项校验:bash scripts/validate-sql-syntax.sh <sql-file>、bash scripts/validate-naming.sh <sql-file>、bash scripts/validate-constraints.sh <sql-file>、bash scripts/validate-indexes.sh <sql-file>、bash scripts/validate-rls.sh <sql-file>。可查看生成的 validation-report.md,或用于 CI/CD,在检测到 ERROR 时使构建失败。

适用场景:迁移文件部署前校验、整个迁移目录检查以及 CI 集成。

限制:需要 PostgreSQL 客户端工具(psql)、Bash 4.0+,并具备架构文件读权限与报告写权限。资料未说明其他平台支持、收费或价格信息。