技能介绍

为什么需要模式清单

在长期迭代的业务系统中，数据库结构往往会随着需求频繁变更而变得臃肿且难以追踪。当准备执行高风险的 DDL 变更或数据库迁移时，团队往往缺乏对线上实际表结构、外键约束和索引依赖的全局视野，这不仅容易引发意料之外的级联故障，还可能在夜间停服窗口造成严重的锁表阻塞。此外，在系统交接或跨团队联调时，过时或缺失的文档也会极大增加沟通成本。

核心能力与工作步骤

该技能通过调度 Agent 调用 SchemaCrawler CLI 工具，直接连接并探查活跃数据库，将其转化为结构化的审查材料。其核心工作流包含以下关键步骤：

元数据提取：自动扫描目标数据库，生成包含表、列、索引及视图的完整模式清单（Schema Inventory）。
依赖关系梳理：解析外键和关联约束，构建清晰的表间依赖视图（Dependency Views），帮助工程师预判变更影响面。
生成审查文档：将上述信息渲染为易读的 Markdown 或文本文档，作为变更方案设计（Design Review）的基准参考。

适用边界与注意点

使用该技能前，运行环境需预先配置好 Java 运行时、SchemaCrawler CLI 以及目标数据库对应的 JDBC 驱动。由于上游项目未提供自动化的安装与使用脚本，在将其接入敏感的自动化运维流水线前，务必手动审查其上游源码以确保安全性。强烈建议在正式变更前，先在数据库的只读副本上执行盘点操作，避免对主库性能造成潜在影响。