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连接数据库以获取数据
进行数据探索或分析（如'how many', 'show me', 'breakdown'）
解释指标或比较时间段
npx skills add Kaelio/ktx --skill ktx-analytics -g -y
将dbt的schema.yml等YAML文件映射为ktx语义层覆盖配置，处理模型/源定义、列描述及数据测试元数据。需结合物理仓库Schema确认实体，避免虚构字段，确保语义层与底层数据一致。
WorkUnit包含skillNames dbt_ingest
检测到models/或sources/下的dbt YAML原始文件
npx skills add Kaelio/ktx --skill dbt_ingest -g -y
从Google Drive文档中提取持久化知识并写入Wiki。适用于包含docs/**内容的WorkUnit，通过读取原始文件、搜索现有页面及上下文证据，合成高质量的业务规则、术语定义或操作指南，避免重复创建，确保知识的可复用性与准确性。
WorkUnit包含来自docs/**的Google Drive原始文件
需要从非结构化文档中提取持久化组织知识
npx skills add Kaelio/ktx --skill gdrive_synthesize -g -y
从历史SQL分析模式数据中提取跨表复用意图，生成结构化证据。通过验证实体标识和SQL执行确认数据准确性，输出符合规范的Wiki或SL源内容。
处理historic-sql适配器输出的模式分片文件
需要从原始数据中识别跨表分析模式并生成文档
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
处理历史SQL表数据，生成类型化的表使用证据以支持确定性模式投影。通过读取原始文件、验证标识符并调用emit_historic_sql_evidence工具，输出包含频率、过滤条件和关联关系的结构化使用叙事。
处理historic-sql适配器的单表JSON文件
需要为表生成确定的schema投影证据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
处理数据束摄入时的冲突分类与解决，涵盖结构重复、定义矛盾及近重复集群。根据重摄入或同批次场景执行静默替换、标记或重命名策略，并在Stage 4负责驱逐决策。
数据摄入时检测到结构重复或定义矛盾
近重复集群需要去重和标准化
Stage 4阶段执行跨工作单元清理和驱逐
npx skills add Kaelio/ktx --skill ingest_triage -g -y
用于从实时数据库快照中捕获语义层和知识更新。通过读取原始表结构、连接元数据和外键信息，创建或更新语义层源，并执行标识符验证协议以确保数据准确性，最后进行校验。
需要处理 raw-sources/live-database 目录下的原始文件
需要从数据库快照同步元数据到语义层
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从 Looker 运行时 JSON 提取指标、语义等知识，经校验后写入数据字典或 Wiki。用于构建和维护结构化业务语义层与知识库。
解析 Looker Dashboard/Look/Explore JSON
提取并标准化业务指标定义
向数据字典或 Wiki 写入语义层内容
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将 LookML 模型映射为 ktx 语义层源，支持 Overlay 和 Standalone 两种形态。包含字段映射、连接处理及写入前的权限检查规则，用于实现从 Looker 到内部数据层的自动化转换。
包含 .lkml 内容
需要将 LookML view/explore 转换为 ktx semantic layer source
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将 Metabase 数据集转换为 ktx 语义层定义，处理类型映射、主外键识别及去重。触发于包含 Metabase 卡片 JSON 的工作单元。
需要转换 Metabase 数据模型为内部语义层格式时
工作单元中包含 cards/<id>.json 文件时
npx skills add Kaelio/ktx --skill metabase_ingest -g -y
处理 Notion 原始内容，通过阅读、搜索证据和现有知识库，合成高质量的持久化 Wiki 条目及语义层数据源，提取业务指标、流程等核心知识，并处理过期内容。
WorkUnit 包含分阶段的 Notion 页面或数据库文件
需要从不相关的 Notion 证据块中提炼结构化知识
npx skills add Kaelio/ktx --skill notion_synthesize -g -y
将 Sigma 数据模型规范和仪表板摘要提取并转换为持久的 wiki 知识。该 Skill 处理 staged 目录下的 JSON 文件，解析表结构和公式，利用已有的语义层 YAML，为特定 WorkUnit 生成结构化文档。
用户需要导入或同步 Sigma 平台的数据模型元数据
用户需要更新或生成基于 Sigma 工作簿的 Wiki 文档
npx skills add Kaelio/ktx --skill sigma_ingest -g -y
指导如何将可复用的业务指标、维度或连接模式捕获到语义层中。涵盖SQL方言适配、通用化设计原则及捕获时机，确保模式库小而有用。
需要定义新的业务度量或计算字段
发现可复用的多表关联模式
构建通用的分析视图或维度
npx skills add Kaelio/ktx --skill sl_capture -g -y
提供ktx语义层(SL)的YAML Schema参考及查询方法。用于理解指标目录结构，并通过sl_query工具查询预定义业务指标(如ARR、留存率等)，支持Overlay和Standalone数据源。
查询预定义业务指标
读取SL YAML了解数据目录
使用sl_query工具
npx skills add Kaelio/ktx --skill sl -g -y
用于从对话或文档中提取持久化业务知识（如指标定义、过滤规则）并写入知识库。自动判断内容价值，避免捕获过时数据或临时指令，确保知识复用性。
用户明确表达业务规则或指标定义
需要建立跨系统映射或别名时
发现需持久化的组织惯例
npx skills add Kaelio/ktx --skill wiki_capture -g -y
用于自动安装和配置 ktx 数据代理上下文层，处理非交互式设置、数据库连接、嵌入模型及代理集成，支持数据源接入和本地环境故障排查。
用户要求添加 ktx 到项目
配置数据源连接
安装代理集成规则
摄入数据模式
排查本地 ktx 安装问题
npx skills add Kaelio/ktx --skill ktx -g -y
