Agent Skills
› Kaelio/ktx
Kaelio/ktx
GitHub用于通过ktx连接查询数据库进行数据分析、指标解释及数据探索。涵盖发现数据、语义层或SQL查询、业务值解析及结果验证，支持复杂分析请求。
Install All Skills
npx skills add Kaelio/ktx --all -g -y
Skills in Collection (16)
用于通过ktx连接查询数据库进行数据分析、指标解释及数据探索。涵盖发现数据、语义层或SQL查询、业务值解析及结果验证，支持复杂分析请求。
需要查询ktx数据库以获取数据的问题
涉及数据探索、指标对比、分组统计的分析请求
npx skills add Kaelio/ktx --skill ktx-analytics -g -y
将dbt的schema.yml和properties.yml映射为ktx语义层覆盖配置，处理模型、来源及列测试元数据。需结合物理仓库结构验证，确保描述准确并生成wiki笔记。
WorkUnit包含dbt_ingest技能
检测到models/或sources/下的dbt YAML文件
npx skills add Kaelio/ktx --skill dbt_ingest -g -y
将 Google Drive 中的原始文档转化为持久化的 Wiki 知识库条目。通过读取文件、搜索现有页面及上下文证据，提取政策、术语等复用知识并写入 Wiki，同时处理过期文件的驱逐决策。
工作单元包含来自 docs/** 的 Google Drive 原始文件
需要将非结构化文档整理为结构化组织知识
npx skills add Kaelio/ktx --skill gdrive_synthesize -g -y
从历史SQL数据分片中识别跨表分析模式，通过验证实体标识符并生成结构化证据，用于确定性的Wiki页面投影。
处理 historic-sql adapter 的模式输入文件
需要从原始SQL日志中提取跨表查询意图
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
将历史SQL表使用数据转换为类型化的证据，用于确定性的模式投影。包含读取原始文件、生成使用叙事及调用证据工具的标准化流程，并严格验证标识符有效性。
处理historic-sql适配器生成的表JSON文件
需要将历史SQL查询转化为结构化表使用证据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
处理数据摄入时的冲突分类与解决，涵盖结构重复、定义矛盾及近重复集群。根据重摄或同批次摄入场景，执行静默替换、标记人类审查、重命名或驱逐决策，确保数据一致性。
检测到结构化重复或定义矛盾
需要决定数据驱逐或覆盖策略
npx skills add Kaelio/ktx --skill ingest_triage -g -y
从实时数据库快照中提取元数据，构建语义层源定义并生成Wiki页面。包含标识符验证协议、类型映射及关联处理，确保数据来源准确与结构合规。
需要处理 live-database 目录下的原始数据文件
需要将数据库表结构转换为语义层源配置
需要基于数据库注释生成业务Wiki文档
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从 Looker 运行时 JSON 提取指标、语义和知识，通过仓库合约写入语义层或 wiki。遵循严格的数据验证与标识确认协议，确保数据准确性并避免重复。
需要解析 Looker dashboard/look/explore JSON
需要从 Looker 查询中提取可复用指标定义
需要构建或更新数据语义层模型
需要将 Looker 运行时证据转化为持久化知识库
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将 LookML 视图、模型映射为 ktx 语义层源，支持 Overlay 和 Standalone 模式。处理类型转换、Join 图及过滤逻辑，并包含连接校验硬限制检查，确保数据写入合规。
包含 .lkml 内容
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将 Metabase 查询、模型和指标转换为 ktx 语义层源定义。涵盖元数据到列类型的映射、主外键检测、去重及预聚合分解，用于生成数据资产文档。
处理包含 cards/<id>.json 的 Metabase 工作单元
需要解析 SQL 结果元数据并生成语义层定义时
npx skills add Kaelio/ktx --skill metabase_ingest -g -y
处理 Notion 页面及数据源，通过读取原始文件、搜索现有 Wiki 和证据，将非结构化内容转化为高质量的持久化 Wiki 条目及语义层数据源，并管理内容淘汰决策。
WorkUnit 包含未处理的 Notion 页面或数据库文件
需要整合分散的 Notion 信息以构建公司知识库
npx skills add Kaelio/ktx --skill notion_synthesize -g -y
将Sigma数据模型规范和仪表板摘要提取并转换为持久的ktx wiki知识。处理sigma-data-models和sigma-workbooks工作单元，解析JSON文件结构以构建知识库内容。
需要导入或同步Sigma数据模型到Wiki时
需要导入或同步Sigma仪表板摘要到Wiki时
npx skills add Kaelio/ktx --skill sigma_ingest -g -y
指导如何将可复用的业务指标、维度或连接模式捕获至语义层，强调SQL方言适配与通用化设计，避免硬编码。
发现可复用的业务指标或计算逻辑
需要定义新的通用数据维度或连接关系
npx skills add Kaelio/ktx --skill sl_capture -g -y
ktx语义层技能，提供业务指标（如ARR、LTV）的YAML目录结构参考及通过sl_query工具查询预定义指标的方法。
查询预定义业务指标
理解SL源YAML目录结构
npx skills add Kaelio/ktx --skill sl -g -y
负责捕获并存储持久化的业务知识（如指标定义、过滤规则、别名映射等）到知识库中。它区分个人与全局作用域，排除临时指令和过时数据，确保知识的复用性和准确性。
用户或文档定义了需长期复用的业务规则
需要建立指标定义或数据映射关系
npx skills add Kaelio/ktx --skill wiki_capture -g -y
用于安装和配置ktx数据代理上下文层，支持非交互式设置、数据库连接、嵌入模型配置及代理集成。适用于添加ktx到项目、连接数据源、构建初始上下文或排查本地安装问题。
用户请求在项目中添加ktx
需要连接数据源或构建初始上下文
安装代理集成规则
排查本地ktx安装故障
npx skills add Kaelio/ktx --skill ktx -g -y
