元数据目录：表、列、注释、示例值

BIRD 专门做了 Database Description File：全名（缩写还原）和值说明（口头词怎么落到库值）。70.1% 的问题需要 value illustration。这不是装饰，是问数软件的核心资产。

目录至少包含：表名、表注释、列名、类型、是否可空、主键/外键、示例值、同义词、敏感标记。金额列要写清单位是元还是分。状态列要写枚举。时间列要写清业务含义（下单/支付/过账）。

公开实现经验：有人只给三十个核心字段补语义注释，可用程度就明显上升。调提示词换不来这份目录。

目录维护要有主人。腐烂的注释比没有更危险——智能体会信它。变更时升版本，旧金标准对旧目录。

出处

• BIRD：Database Description File 与 Value Illustration 占比 70.1%
• 腾讯云问数实现文：Schema 描述质量决定准确率上限