SuperAPI AI 工具集

rde

数据与分析

查看项目

更新于 10-15 02:54

技能介绍

rde 是 Metabase agent-skills 中的一项数据工程技能,目标是在以 Metabase 为中心的数据栈中,以数据工程师的角色完成从原始表探查到清洗建表、语义层定义与结果交付的完整流程。

用途:该技能用于指导代理执行数据工程任务,例如探查与剖析仓库中的原始表、构建干净的 transform 表、定义指标/度量/模型/语义层、构建仪表盘、回答具体业务问题,或校验与对账相互矛盾的数字。

主要能力与工作方式:

  • 每份工作只加载一个剧本(playbook),读取其 “Read first” 指定的内容后按清单执行;进度记录在 STATE.md 的 stage 与 next 中。
  • 工作前执行 cat ./.scratch/STATE.md,若不存在则在得知 profile 后按 schema 创建;同时检查 mb --version 与 mb auth list --json 以确定可用实例。
  • 每份工作读取一次 references/collaboration-contract.md,其输出与自主模式记录在 STATE.md。
  • 在首次 mb transform create 之前必须经过一次「pre-create gate」检查点,内容仅包含已通过剖析测得的既有构建、数据新鲜度与待决问题清单(memo);该检查点不可跳过,且不得与后续消息合并。用户未回答的检查点不得视为已通过。
  • 命令约定:所有命令使用 --profile $PROFILE 与 --json,解析结构化输出而非抓取文本;列表信封为 {returned, offset, total, has_more, next_offset, data},用 --offset 继续;请求体由 ./.scratch 中的文件通过 --file 提供。
  • 迭代使用 update 而非删除重建;transform 的规则由 transform 测试固定,且在物化前与每次 patch 前都要运行。
  • 工作落点需一次性询问并记录为 environment(production 或 staging);生产环境中未完成的表需对选择器隐藏、未完成的仪表盘放在 Drafts 集合;staging 环境则自由构建后交付分支供评审。
  • 远程同步相关:通过 mb git-sync status --json 判断是否配置,记录 remote_sync;若配置了 synced_root,则卡片、仪表盘、文档、指标等集合需置于 synced_root 之下,指标与已发布表最终进入 Library,transform 保持 --namespace transforms 集合并通过 remote-sync-transforms 同步。

路由规则(首个匹配生效):明确要求构建应用(data app)时先路由到 rde-data-apps 技能;STATE.md 已存在则从其阶段继续;涉及引用、不匹配或两个数字冲突则进入 validate-and-reconcile 剧本;以代码、文档、表格或其他工具项目为规则来源则进入 extract-business-logic;询问某张现有表是什么则不使用剧本,读取相关元数据并用通俗语言回答;要求修改或质疑已交付定义则走 semantic-layer-design 的变更流程;要求测试 transform 或指出某个用例错误则使用 build-clean-tables 的第 4、5 步;要求仪表盘则使用 build-dashboards(若数据库无 transform 与 metric 则从管线第 9 步开始);要求定义、指标、度量、模型或让 Metabot/AI 更好回答则使用 build-semantic-layer;要求干净表或提出晚于数据现状的目标则从 explore-raw-data 开始走管线;要求某个数字、列表或结论则使用 answer-a-question;否则使用 explore-raw-data。

薄切片原则:任何管线的首轮只端到端交付一个核心数字(用户最先提到的那个),在首个会话中标记为 Draft 交付,之后按 STATE.md 中 Questions 的顺序推进下一个数字。范围从问题反推,不在任何命名问题路径上的表仅列出并保持原始状态。

领域参考:按表名匹配加载,如含 invoice/subscription/plan/price 等名称时加载 subscription-revenue,含 registration/attendee/session/webinar/survey 时加载 event-and-registration-data,含 event/activity/usage/login/page view/workspace 时加载 product-usage-events;多个规则同时命中时需先看列判断实际所属领域;留存、同期群与一致性实体使用 entities-and-time。

不变量:out_schema 中不得在 pre-create gate 返回前创建任何内容;先剖析再建模;每个模型在建前需声明粒度与键,且每条规则在物化前由 transform 测试固定,测试未通过不得物化;结构检查不等于正确性,核心数字需与独立数字对账后才可超出 Draft 标签;尾期不完整的数据应作为被标记的行而非缺失;业务规则由用户决定、约定由公司保持;一个数字只有一个定义;配置 synced_root 时,已完成内容不得留在其外或 Library 之外;每个阶段以五部分 hand-back 与浏览器链接结束,工作以 leave-behind 文档收尾。

限制与缺失事实:资料未说明该技能的收费、价格、授权方式、支持平台范围、Metabase 具体版本要求或性能指标,上述内容暂未提供。