用途：当需要对业务指标、维度或实体建立统一定义与文档时使用。适用于利益相关方询问某指标如何计算但缺少权威定义、搭建 dbt Semantic Layer 需要 YAML 定义、多团队对同一指标使用不同 SQL 需固化唯一定义，或为核心模型编写数据目录条目等场景。
主要能力：区分要记录的对象类型（指标、维度或实体），并借助 references/metric_definition_framework.md 与 references/dimension_hierarchy_patterns.md 中的框架辅助。收集定义输入，包括计算逻辑（SQL 或公式）、业务背景、数据源、粒度、边界情况与已知陷阱，不清楚时可询问数据负责人。通过 scripts/metric_template_generator.py 生成初始 YAML 模板，再用 scripts/model_yaml_validator.py 校验必填字段、类型约束和引用完整性（所引用维度需存在于同一文件）。如需部署到 dbt Semantic Layer，可参考 references/dbt_semantic_layer_guide.md 获取对应 dbt 版本的字段名与约束。最终将指标、维度、实体定义分别保存到 assets/metric_definition.yaml、assets/dimension_definition.yaml、assets/entity_definition.yaml。
所需输入：必填为要记录的指标名或模型名、计算逻辑、业务背景；可选为数据源表与列名、目标语义层框架（dbt Semantic Layer、Cube.js、LookML 等）及待校验的现有 YAML。
限制：收费、价格、平台支持范围等资料暂未提供。