用途:创建或扩展 nao 项目的 RULES.md,并负责该文件的模板。RULES.md 会随每条消息加载给 nao 智能体,因此需保持精简,只承担两类用途:编排器(快速指向正确上下文,如指标到定义、主题到文件、问题类型到技能)与通用规则(如何查询、如何回答)。其他内容(逐表 schema、完整指标语义、领域规则)应放在被引用的文件中,RULES.md 只指向而不复制。
主要能力:先盘点上下文仓库(nao_config.yaml、databases/、repos/、docs/、semantics/),再按标准章节逐段生成:业务概览、数据架构、上下文地图、核心数据模型、关键指标参考、日期过滤、分析流程、图表与可视化指南。若 RULES.md 已有内容,则运行审计与补全流程,输出缺口报告并标记重复内容。
使用方式:逐段生成并展示给用户,不一次性批量写入;保存前展示差异,不自动覆盖。日期过滤仅保留三个示例公式(最近 X 周、最近 X 天、当前月)。过滤任何列值前必须先读取该表的 profiling.md。
适用场景:需要为 nao 项目生成初始 RULES.md,或对已有 RULES.md 做审计、补全与去重。
限制:不编造指标来源,不明确时列出交由用户验证;图表指南仅在项目产出图表且用户有真实品牌色板时添加,且必须使用其确切十六进制值;无品牌色板则省略该章节。更深入的诊断(MECE、schema 漂移、测试失败根因)应转向 audit-context。