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查询的技能。涵盖数据发现、语义层查询、字典解析及结果验证，适用于回答各类数据分析请求。
需要查询数据库获取数据
数据分析与指标解释
记录查找与对比
npx skills add Kaelio/ktx --skill ktx-analytics -g -y
将dbt YAML文件中的模型、源及列级测试元数据映射为ktx语义层覆盖配置，确保物理 schema 一致。
上传包含dbt_project.yml的项目包
WorkUnit skillNames包含dbt_ingest
检测到models/或sources/下的dbt YAML文件
npx skills add Kaelio/ktx --skill dbt_ingest -g -y
从Google Drive文档中提取持久化业务知识并写入Wiki。流程包括读取原始文件、搜索现有页面以避免重复、利用上下文证据辅助事实核对，最终生成高质量、可复用的组织知识条目，同时处理被驱逐文件的保留决策。
WorkUnit包含docs/下的Google Drive原始文件
需要将非结构化文档转化为结构化Wiki知识
npx skills add Kaelio/ktx --skill gdrive_synthesize -g -y
从历史SQL数据中识别跨表分析模式，验证实体标识后生成结构化证据，用于确定性的Wiki内容投影。
处理 historic-sql adapter 输出的 patterns-input JSON 分片文件
需要从历史查询日志中提取重复使用的跨表分析意图
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
处理历史SQL表使用数据，生成结构化使用证据。包含读取原始文件、验证标识符真实性及调用工具输出表使用详情等流程。
需要解析历史SQL适配器中的表使用JSON文件
需要将表使用数据转换为结构化的schema投影证据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
用于数据束摄入阶段的冲突分类与解决，处理结构重复、定义矛盾及驱逐决策。
Stage 3 WorkUnit 写入前检测重叠
Stage 4 跨单元合并与驱逐
npx skills add Kaelio/ktx --skill ingest_triage -g -y
用于从实时数据库快照中捕获语义层和知识更新，通过读取原始JSON文件、连接元数据及外键信息，创建或更新语义层源，并执行标识符验证协议以确保数据准确性。
处理包含原始数据库快照文件的摄入工作单元
需要从数据库结构生成语义层源定义
需要验证数据库标识符是否存在
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从 Looker 运行时数据中提取指标、语义和字段定义，写入知识图谱或 Wiki。通过验证协议确保数据准确性，避免重复，实现持久化记忆构建。
需要解析 Looker 仪表板或查询的元数据
构建或更新语义层知识库
提取可复用的业务指标定义
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将 LookML 模型映射为 ktx 语义层源，支持 Overlay 和 Standalone 模式。包含类型转换、连接检查及写入规则，用于数据建模与集成。
包含 .lkml 内容
需要构建语义层
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将 Metabase 查询、模型和指标转换为 ktx 语义层源定义，处理类型映射、主外键识别及去重。新增标识符验证协议，要求写入前通过 discover_data 检查现有资源并优先更新。
需要转换 Metabase 数据为语义层定义
WorkUnit 包含 cards/<id>.json 文件
npx skills add Kaelio/ktx --skill metabase_ingest -g -y
用于从 Notion 页面、数据库及证据中合成持久化的 Wiki 条目和语义层数据源，提取核心业务知识与指标，更新现有文档并处理废弃内容，确保知识沉淀与复用。
工作单元包含未处理的 Notion 原始文件或证据块
需要从 Notion 内容中提取可复用的业务定义或数据映射
npx skills add Kaelio/ktx --skill notion_synthesize -g -y
从暂存的 Sigma 数据模型和工作簿中提取知识，生成持久的 wiki 内容。处理数据模型与工作簿的批量导入及文件结构解析。
需要提取 Sigma 数据模型知识时
需要导入 Sigma 工作簿摘要时
npx skills add Kaelio/ktx --skill sigma_ingest -g -y
指导如何将可复用的业务指标、维度或连接模式捕获到语义层目录中。涵盖判断标准、SQL方言适配及泛化规则，确保模式通用且易于维护。
发现可复用的业务指标或分析视图
需要定义新的通用数据维度
npx skills add Kaelio/ktx --skill sl_capture -g -y
提供ktx语义层的使用指南，涵盖YAML Schema参考及通过sl_query工具查询预定义业务指标（如ARR、留存率等）的方法，帮助理解数据目录结构。
需要查询预定义的业务指标
阅读或理解语义层源文件的YAML结构
了解如何查询数据目录
npx skills add Kaelio/ktx --skill sl -g -y
负责从对话或文档中提取持久化业务知识（如指标定义、业务规则、别名映射），并写入Wiki知识库。自动过滤临时指令和过时数据，确保知识复用性。
用户定义了新的业务指标或计算逻辑
确立了特定的数据过滤或处理惯例
建立了字段与外部系统的映射关系
npx skills add Kaelio/ktx --skill wiki_capture -g -y
用于自动化安装和配置 ktx 数据代理上下文层，包括数据库连接、嵌入模型设置及 Agent 集成。适用于项目初始化、数据源接入、本地环境排查等场景。
用户要求将 ktx 添加到项目中
需要连接数据源或构建初始上下文
安装 Agent 集成规则
导入 Schema 或处理本地 ktx 安装故障
npx skills add Kaelio/ktx --skill ktx -g -y
