Agent Skills
› Kaelio/ktx
Kaelio/ktx
GitHub用于连接ktx数据库进行数据分析的Skill。涵盖数据发现、语义层分析、SQL查询及结果验证，支持探索性分析、指标解释和记录查找等场景。
Install All Skills
npx skills add Kaelio/ktx --all -g -y
Skills in Collection (16)
用于连接ktx数据库进行数据分析的Skill。涵盖数据发现、语义层分析、SQL查询及结果验证，支持探索性分析、指标解释和记录查找等场景。
需要查询ktx数据库进行分析
询问'有多少'、'展示'、'分解'等数据问题
按值查找记录或比较时间段
解释业务指标
npx skills add Kaelio/ktx --skill ktx-analytics -g -y
将dbt的schema.yml和properties.yml映射为ktx语义层覆盖配置，处理模型与源、列描述及数据测试元数据。需结合仓库实际物理结构验证后写入，确保文档与真实Schema一致。
WorkUnit skillNames包含dbt_ingest
检测到models/或sources/下的dbt YAML文件
npx skills add Kaelio/ktx --skill dbt_ingest -g -y
将Google Drive文档转化为结构化Wiki知识。读取原始文件与元数据，搜索现有页面避免重复，利用上下文证据验证事实，撰写高质量持久化业务规则、术语及流程说明，并处理文件驱逐决策。
WorkUnit包含docs/下的Google Doc原始文件
需要将分散的文档整合为可复用的组织知识
npx skills add Kaelio/ktx --skill gdrive_synthesize -g -y
从历史SQL数据分片中识别跨表分析模式，通过实体验证协议确保标识符准确性，并输出结构化模式证据以支持Wiki生成。
处理 historic-sql 适配器的 patterns-input 数据分片
需要提取跨表关联的分析意图
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
将历史SQL表使用数据转换为类型化的表使用证据，用于确定性的模式投影。通过解析原始JSON并调用工具生成包含频率、过滤条件及关联信息的结构化描述。
处理 historic-sql 适配器的表JSON文件
需要将SQL查询日志转化为标准表元数据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
处理数据打包摄入时的冲突分类与解决，包括结构重复、定义矛盾及近重复聚类。涵盖同批次内去重、跨批次重新摄入的语义/表达式变更处理，以及Stage 4阶段的驱逐决策，确保数据一致性。
数据摄入时检测到结构重复或定义矛盾
需要处理近重复聚类的去重逻辑
执行跨工作单元的重审与驱逐决策
npx skills add Kaelio/ktx --skill ingest_triage -g -y
从实时数据库快照中提取元数据，构建语义层源定义。涵盖读取表结构、外键关联及验证标识符真实性，确保生成的Wiki和SL源准确无误。
处理 live-database 同步目录下的原始文件
需要基于数据库快照创建或更新语义层源
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从Looker运行时JSON中提取指标、语义及业务规则，通过验证协议写入语义层或Wiki。确保数据一致性并避免重复，将运行时证据转化为持久化知识资产。
需要解析Looker仪表盘、查询或探索的JSON配置
需从运行时数据提取业务逻辑并更新知识库或语义层
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将LookML语义层定义转换为ktx格式，支持Overlay和Standalone两种模式。自动处理类型映射、Join关系及过滤条件，并包含连接不匹配时的硬拦截逻辑，确保数据模型正确落地。
用户输入包含 .lkml 文件内容
需要将 LookML 视图/模型转换为 ktx 语义层源
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将 Metabase 查询、模型和指标转换为 ktx 语义层源定义，处理类型映射、主外键检测及去重。
WorkUnit 包含 cards/<id>.json 文件
需要生成 ktx 语义层源定义
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-data-models 和 sigma-workbooks 工作单元的数据摄入任务。
需要摄入 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、留存率）的方法，用于理解数据模型和获取可复用指标。
查询预定义业务指标
阅读SL源YAML以理解目录结构
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
