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语义层覆盖配置，处理模型/源、列描述及数据测试。需结合仓库物理结构验证，避免虚构列，确保元数据准确同步至语义层。
WorkUnit的skillNames包含dbt_ingest
检测到models/或sources/下的dbt YAML文件
npx skills add Kaelio/ktx --skill dbt_ingest -g -y
该 Skill 用于将 Google Drive 中的原始文档转化为结构化、持久的 Wiki 知识页面。通过读取文件、搜索现有内容并综合信息，提取政策、术语等核心知识，同时处理废弃文件，确保知识库的准确性与复用性。
工作单元包含来自 docs/** 的 Google Drive 原始文件
需要从非结构化文档中提取和整理组织级持久化知识
npx skills add Kaelio/ktx --skill gdrive_synthesize -g -y
从历史SQL分析模式中识别跨表重复意图，验证实体标识后生成结构化模式证据，用于确定性的Wiki投影。
处理 historic-sql 适配器的 patterns-input JSON 分片文件
需要从原始数据中提取跨表分析模式并生成证据
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
处理历史SQL表数据，提取使用证据并生成结构化元数据。通过验证标识符准确性，分析查询模式（过滤、分组、连接）及频率，最终调用工具输出标准化的表使用记录，支持确定性架构投影。
需要解析历史SQL适配器的表JSON文件
生成表的使用叙事和结构证据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
处理数据导入时的冲突分类与解决，包括结构重复、定义矛盾和近重复簇。根据上下文（Stage 3/4）及变更类型（表达式或结构）执行静默替换、重命名或标记人工审核，并管理驱逐决策。
检测到 bundle ingest 中的结构重复
发现定义性矛盾或近重复簇
需要处理 re-ingest 的语义破坏
执行 Stage 4 驱逐决策
npx skills add Kaelio/ktx --skill ingest_triage -g -y
该技能用于从实时数据库快照中捕获语义层和知识更新。通过读取原始JSON文件及连接元数据，创建或更新语义层源，处理外键关联，并基于严格标识符验证协议生成Wiki页面，确保数据来源准确无误。
工作单元包含 raw-sources/live-database 下的原始文件
需要从数据库模式快照中提取语义层源
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从 Looker 运行时 JSON 提取指标、语义层定义等知识，通过工作流验证并写入知识库或语义层，确保数据准确性与一致性。
需要解析 Looker Dashboard/Look/Explore JSON
构建或更新语义层(SL)和Wiki知识
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将 LookML 模型映射为 ktx 语义层源，支持 Overlay 和 Standalone 两种模式。涵盖字段类型转换、连接图构建及过滤规则处理，并包含基于连接匹配的检查逻辑以防止无效写入。
用户询问如何将 LookML 转换为 ktx 格式
输入内容包含 .lkml 文件片段或相关配置
需要解析 LookML view/explore 结构以生成语义层定义
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将Metabase数据卡片转换为ktx语义层源定义，处理元数据映射、主外键检测及去重。触发于包含cards JSON文件的WorkUnit。
解析Metabase卡片JSON以生成语义层定义
执行Metabase到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 数据模型和工作簿的暂存 JSON 规范转换为持久的 ktx wiki 知识。根据 unitKey 区分处理数据模型与工作簿，解析源结构并生成文档，不重写已生成的语义层 YAML。
需要提取 Sigma 数据模型或工作簿的结构化知识到 Wiki
Staged 目录中存在 sigma-data-models 或 sigma-workbooks 类型的 WorkUnits
npx skills add Kaelio/ktx --skill sigma_ingest -g -y
指导如何将可复用的业务指标、维度或关联模式捕获到语义层目录中，确保定义通用且语法适配特定数据仓库方言，以提升后续查询效率。
识别出可复用的业务指标或计算逻辑
需要定义新的语义层度量或维度
npx skills add Kaelio/ktx --skill sl_capture -g -y
ktx语义层技能，提供指标目录查询与YAML模式参考。用于通过sl_query获取ARR、留存等预定义业务指标，或读取SL源文件理解数据模型结构。
需要查询预定义业务指标（如ARR、LTV）
需解析语义层YAML以理解数据模型
npx skills add Kaelio/ktx --skill sl -g -y
负责从对话或文档中提取持久化业务知识（如指标定义、业务规则），经去重与交叉引用检查后写入Wiki知识库，避免存储易过期的数据快照。
用户明确表达需长期复用的业务定义或规则
外部文档导入需转化为持久化知识条目
npx skills add Kaelio/ktx --skill wiki_capture -g -y
用于自动安装和配置 ktx 数据代理上下文层，包括连接数据库、嵌入后端及智能体集成。支持非交互式设置、凭证管理及本地环境故障排除。
用户要求添加 ktx 到项目
连接数据源或构建初始上下文
安装智能体集成规则
摄取 schema
排查本地 ktx 安装问题
npx skills add Kaelio/ktx --skill ktx -g -y
