1600张表，手动整理？

算笔账。1613张表，每张表平均26个字段，手动复制粘贴到Excel，一张表至少3分钟。1600张表就是80个小时——整整两周不干别的，光整理文档。

而且这只是第一次。以后每次数据库变更，都要手动对比哪里改了、更新文档、标注新增字段。这件事只要靠人，就一定会遗漏。

配图：代码写完了，文档呢？

我决定写一个脚本，连库自动提取元数据，直接生成格式化的Excel文档。后来发现这个需求太通用了——每个接手老项目的程序员都遇到过。干脆做成一个Skill，以后任何数据库都能一键生成。

配图：1600+张表，手动整理？

二、自动生成Excel文档
核心思路很简单：连数据库 → 提取表结构元数据 → 生成格式化Excel。

但真做起来，细节不少。

四种模板风格
不同团队审美不一样，做了四种模板：经典商务蓝、极简线条、深灰紧凑、清新绿白。模板用JSON配置，想加新风格丢个文件进去就行。

① 模板A

模板A

②模板B

模板B

③模板C

模板C

④ 模板D

模板D

30秒，1613张表全部生成。标题行、表信息、字段明细、列宽、边框、冻结行——全自动。

对比旧文档，自动标注新增
这个功能是真正解决痛点的。传入旧文档路径，脚本会自动对比：

新增的表：蓝色标注，归入"未分类"组
新增的字段：蓝色高亮该行
类型变更的字段：橙色标注类型列
旧文档中的中文注释：自动合并保留
这样每次数据库变更后，跑一次命令就能看到哪些是新增的，哪些改了类型。不用肉眼对比。

旧版手工维护Excel vs 自动生成Excel

核心痛点解决：从"手动整理80小时"变成"一条命令30秒"。而且每次变更都有视觉标注，不会再遗漏。

三、同步到飞书：电子表格方案
Excel生成好了，但团队协作场景下，Excel文件传来传去太低效。需求方提出：能不能同步到飞书，在线查看？

最终采用了飞书电子表格（Sheets）方案：每张表一个独立 Sheet，完全复刻 Excel 的格式和样式。

飞书电子表格 - 目录Sheet

目录Sheet里每张表的名称是超链接，点击直接跳转到对应Sheet。Sheet底部标签显示中文表名（优先用数据库注释，没有注释才用英文表名）。

新建项目

每张表的Sheet格式跟Excel一模一样：标题行、表信息、描述、数据组成、字段表头、字段数据，冻结前7行，列宽已调整。数量超过单个电子表格上限时，自动拆分创建新的电子表格。

配图：一键生成，四种风格

协作痛点解决：从"Excel文件传来传去"变成"飞书在线查看，点击跳转"。目录Sheet带超链接，中文标签一目了然。

四、定时自动化：凌晨两点自动同步
文档生成好了，飞书也同步了。但还有一个问题：每次数据库变更都要手动跑命令。

如果忘了跑呢？文档又过时了。

所以用 WorkBuddy 的自动化任务配置了一条定时流程：每天凌晨 2:00 自动检测数据库变更，有变更则重建飞书电子表格，同步成功才更新基线；失败则保留旧基线，下次自动重试。

配置自动同步

自动同步设置

当然了其他的AI Agent也是一样的设置自动化任务就行

自动化同步流程