算笔账。1613张表每张表平均26个字段手动复制粘贴到Excel一张表至少3分钟。1600张表就是80个小时——整整两周不干别的光整理文档。而且这只是第一次。以后每次数据库变更都要手动对比哪里改了、更新文档、标注新增字段。这件事只要靠人就一定会遗漏。配图代码写完了文档呢我决定写一个脚本连库自动提取元数据直接生成格式化的Excel文档。后来发现这个需求太通用了——每个接手老项目的程序员都遇到过。干脆做成一个Skill以后任何数据库都能一键生成。配图1600张表手动整理二、自动生成Excel文档核心思路很简单连数据库 → 提取表结构元数据 → 生成格式化Excel。但真做起来细节不少。四种模板风格不同团队审美不一样做了四种模板经典商务蓝、极简线条、深灰紧凑、清新绿白。模板用JSON配置想加新风格丢个文件进去就行。① 模板A模板A②模板B模板B③模板C模板C④ 模板D模板D30秒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也是一样的设置自动化任务就行自动化同步流程