用途：为 Observe 平台生成合法的 OPAL 管道查询，属于 Observe CLI 的技能（skill）。核心技能只覆盖通用语法与路由，日志、指标、span、join、时长等专门模式位于 opal-* 参考文件中。
主要能力：提供数据集类型选择（Event/log、Event/metric、Interval/otel_span、Resource、Table）及对应聚合动词；列选择规则（用 pick_col 保持输出精简，主键列与时间列必填，valid-from 用 row_start_time()、valid-to 用 row_end_time()）；核心语法规则，包括注释、时间过滤、类型转换、make_col 前向引用、group_by 命名、列名冲突、sort 用 desc()/asc()、timechart 位置参数、frame() 用法、rename_col/drop_col、数据集类型转换动词、dedup、字符串匹配与 POSIX ERE 正则等。
使用方式：先确定每个数据源的数据集类型与接口，然后必须停止并加载技能索引中所有匹配的 opal-* 参考文件（例如 cat /skills/generate-opal/references/opal-logs.md），多个匹配时全部读取，之后才编写 OPAL 管道。涉及多数据集时必须先读 opal-join-patterns。
适用场景：Observe 中日志过滤与解析、指标聚合、span 延迟与追踪、跨数据集 join/lookup、正则匹配、可视化输出形状等查询生成。
限制：OPAL 的 join/lookup/集合运算语法非标准，不能依赖 SQL 知识；不得在 OPAL 中过滤时间列；Resource 类型不支持 limit，需用 topk；topk/bottomk 需聚合评分；无 count_if、无 in 运算符、无 SQL CASE/WHEN；正则不支持 \d、\w、\s 及非贪婪量词；字段名必须来自数据集 schema，不得猜测。除仅含 filter + pick_col 的简单单数据集查询外，均应加载参考文件。具体安装命令与收费信息暂未提供。