---
name: db-schema
version: "1.0.0"
category: database
description: "数据库表结构分析 / 表关系图谱、字段清单、索引分析 — 从 DDL 或实际数据库提取结构信息"
triggers:
  zh: ["表结构", "表关系", "ER图", "字段", "索引", "外键", "DDL分析", "schema", "建表语句"]
  en: ["table structure", "ER diagram", "schema", "DDL", "index", "foreign key"]
license: MIT
compatibility: opespro-opencode >= 2.3.0
dependencies:
  - scripts/db-schema-analyze.js
metadata:
  author: "OpesPro Team"
  created: "2026-06-29"
  status: "stable"
  agent_profile: db-master
---

# DB Schema / 数据库表结构分析

## Changelog

| 日期 | 版本 | 变更 |
|------|------|------|
| 2026-06-29 | 1.0.0 | 初始版本 |

---

## Core Concept

**Input:** DDL 文件 / 表名 / 数据库连接 | **Output:** 结构化的表结构文档 + ER 关系图描述

---

## Iron Law

1. 只读操作 — 不执行任何 DDL/DML 修改
2. 分析的 DDL 先通过 `db-query` 的校验脚本
3. 输出格式：Markdown 表格 + ER 关系文字描述

## Workflow

```
DDL 文件 / 数据库连接
    ├→ 1. 解析 DDL: node scripts/db-schema-analyze.js --source=tables.sql
    ├→ 2. 提取: 表名、字段、类型、主键、索引、外键
    └→ 3. 输出: Markdown 表结构文档 + ER 关系描述
```

## Scripts

| Script | 用途 |
|--------|------|
| `scripts/db-schema-analyze.js` | 从 SQL 文件提取表结构信息 |