SuperAPI AI 工具集

profile-source

数据与分析

查看项目

更新于 10-16 07:57

技能介绍

用途:把一个数据团队不拥有所有权的上游数据源(数据库表、SaaS endpoint、流式 topic、合作方 feed),转换成消费者项目 docs/sources-of-record/<system>-<entity>.md 下的 Source Profile。它记录的是数据源的运营与契约模型(schema 权威、投递模式、迟到行为、值班、回放窗口),是人工撰写的,不从实时连接推断,也不是统计列画像。

主要能力:以分支式访谈方式运行,每轮一个问题;自带契约 references/source-profile.md 和校验脚本 scripts/lint-source-profile.sh(接受的档案若 consumed_by 为空会校验失败)。核心是 Generation kill-switch:必须先指名至少一个 docs/requirements/ 下 accepted 或 draft 的消费 DGQ;无法指名则不写档案,建议先做非正式探查或运行 /gather-requirements。启动前先做可恢复性检查,扫描已有 Source Profile,可选择续写草稿、新建或列出。

用法:七轮依次进行——命名消费 DGQ、识别数据源(system/entity/owner)、schema 与 schema 权威(producer-owned/data-team-owned/shared-contract)、投递模型(cdc/pull-batch/push-batch/streaming/webhook/manual-export,按流式或批量分支追问)、运营契约(值班、恢复、回放、上游保留、SLA)、暗流扫描(敏感度、治理、成本规模,合并一轮)、写出档案。每轮遵循先推荐再询问、先查仓库再询问的原则;不接受以非活跃 DGQ 开启档案,不代用户编造消费方。多个数据源时先深挖一个,其余写为 status: draft 的存根。

适用场景:为数据源建立运营契约文档,串联 DGQ 与数据源消费关系,支持数据治理与上游风险评估。

限制:资料未提供具体安装命令、价格、平台支持或运行环境信息;是否需要额外依赖、支持的模型与版本等均暂未提供。