字段血缘与依赖梳理 Skill

--- name: lineage-map description: 把字段映射清单变成上下游依赖报告：每个字段的上游来源与下游去向一目了然，自动预警断链与疑似废弃字段，改表结构前先查依赖。 --- # 字段血缘与依赖梳理 Skill ## 触发条件 当要改表结构、下线旧字段、接手陌生数仓，或报表数字对不上要追字段来源时触发。 ## 执行步骤 1. 把字段映射整理成 templates/mappings.csv 的格式（源表、源字段、目标表、目标字段、转换说明）。 2. 运行 python scripts/lineage_map.py mappings.csv -o lineage.md，可选 --dot 导出 Graphviz 图。 3. 先看断链预警：目标字段缺来源的，先补清单再动数据。 4. 改字段前查「下游去向」列，被依赖的字段不能直接删改，要走通知与迁移流程。 5. 转换说明写清口径（单位换算、时区、取哪一笔），让半年后的人也能看懂。 ## 依赖 Python 3 标准库（csv/argparse/collections），不连数据库，只读映射清单文件。 ## 输出 一份 lineage.md：断链预警、字段上下游表、映射明细；可选 lineage.dot 依赖图。