SuperAPI AI 工具集

postgres-agents-migration-reviewer

数据与分析

查看项目

更新于 10-16 06:18

技能介绍

用途:该技能把 Claude 变成迁移安全审查员,用于在生产运行前审查数据库迁移,或审计拉取请求中的迁移文件。它是编排型技能,不是 DDL 参考,定义了固定的 14 项检查清单、严重度分级方案,以及每条发现应引用哪个同级技能。

主要能力:审查流程为 PARSE(拆分语句、识别 DDL/DML 类型与目标表、记录事务边界)、CHECK(运行全部 14 项检查 M-1..M-14 并记录位置)、LOCK(对锁问题建议在生产规模数据副本上、并发负载下计时演练)、REPORT(输出结构化发现与一个总体结论)。严重度分 CRITICAL、WARNING、INFO;结论为 SAFE、NEEDS-CHANGES、UNSAFE。核心原则是锁的危险取决于并发流量而非表大小。

检查项覆盖:无 CONCURRENTLY 的 CREATE INDEX、重写表的 ALTER COLUMN TYPE、带 volatile DEFAULT 的 ADD COLUMN、有数据表上无默认值的 NOT NULL、未走 NOT VALID 路径的 SET NOT NULL、未用 NOT VALID + VALIDATE 的外键或 CHECK、DROP/RENAME 列或表、缺少 lock_timeout 保护、单条大 UPDATE/DELETE 回填、DDL 与重数据变更同事务、事务块内 CONCURRENTLY、无回滚路径、迁移中的 TRUNCATE、分区表上的索引或约束。

使用方式:当用户询问迁移是否安全、要求审查迁移、询问是否会锁表,或粘贴迁移文件时使用;也用于审计 PR 或部署差异中的迁移,以及审查其他代理生成的生产 schema 变更 SQL。输出为发现列表加一行结论,每条发现含严重度、检查编号、位置、问题、修复与引用技能。

限制:不用于审查普通查询性能、从零编写迁移或审查表设计规范化;不得仅凭目视批准迁移。具体命令与完整报告模式见其 references 文件。