用途:诊断 nao 上下文的健康状况,找出缺口、MECE 违规、失败根因与内容膨胀。仅诊断、不修复,修复按类型路由到 write-context-rules、add-semantic-layer、create-context-tests。可在 setup-context 之后、构建中、发布前或 agent 行为异常时运行。
主要能力(六项按序检查):1)同步上下文:读 nao_config.yaml,检查已接入与缺失项,确认 nao sync 是否运行、databases/、repos/、docs/、semantics/ 是否填充;范围硬上限 100 张表,目标 ≤20。2)RULES.md 对比目标结构:六个标准段(业务概览、数据架构、核心数据模型、关键指标参考、日期过滤、分析流程)标记存在/缺失/单薄,标出占位符、TODO 与无来源指针的指标。3)逐表上下文覆盖:是否在 Most Used Tables、有无 Tables detail 块、有无 dbt 上下文与额外 .md,并列出未文档化列、无解释计算字段、无关系外键、未提及常用 WHERE 过滤。4)数据模型一致性(MECE):互斥性(重复计算同一指标)、穷尽性、重复列、歧义列。5)测试覆盖:若 tests/ 为空则建议 create-context-tests;否则读 tests/outputs/ 最近运行,将失败归类为数据模型、日期选择、测试问题、解释、指标定义,并给出每条最小规则改动,按影响排序。6)Token 优化:标出 >40KB 文件、超过 10 列上限的 Tables detail、RULES.md 与表文档重复、无测试或近期问题引用的表、混入范围的 raw/staging 表。
输出:对话内报告,先一段摘要(同步状态 | 范围宽窄 | 规则质量 N/6 | 测试覆盖 N 个、通过率),再仅展开有发现的段落,以按优先级计划结尾,每项标注对应技能。
限制与护栏:一次只应用一个改动,修复间重跑测试;测试是事实来源;未经确认不移动或拆分文件,先展示文件映射;本技能不做修复。