Agent Skills
› Kaelio/ktx
Kaelio/ktx
GitHub用于通过ktx数据库进行数据探索、指标分析及SQL查询的Agent技能。涵盖从发现数据源、语义层分析到执行只读SQL并验证结果的全流程，支持自然语言转数据查询。
安装全部 Skills
npx skills add Kaelio/ktx --all -g -y
集合内 Skills (16)
用于通过ktx数据库进行数据探索、指标分析及SQL查询的Agent技能。涵盖从发现数据源、语义层分析到执行只读SQL并验证结果的全流程，支持自然语言转数据查询。
需要查询ktx连接数据库中的数据
询问'有多少'、'展示给我'或'细分情况'
按值查找记录、探索表结构
比较时间段或解释指标
任何涉及数据分析的请求
npx skills add Kaelio/ktx --skill ktx-analytics -g -y
将上传的dbt项目YAML文件映射为ktx语义层覆盖配置，解析模型、源及列测试元数据，并结合物理仓库Schema确认实体后写入语义层或Wiki。
处理上传的dbt项目YAML文件
需要将dbt元数据同步至ktx语义层
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或SL源内容，用于构建确定性的知识图谱投影。
需要识别跨表SQL分析模式
处理historic-sql适配器生成的模式输入分片
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
将历史SQL表使用数据转换为类型化的证据，用于确定性的模式投影。通过读取原始文件、验证标识符并生成使用叙事，最终调用工具输出表格使用证据。
处理 historic-sql 适配器生成的表 JSON 文件
需要为数据库表生成结构化的使用证据和元数据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
用于在数据打包摄入阶段自动分类并解决结构重复、定义矛盾及近重复冲突，通过决策树判断是否静默替换、标记或重命名，并在第四阶段处理驱逐逻辑。
Stage 3 WorkUnit写入前检测到现有项目记忆或先验证明重叠
Stage 4协调代理进行跨WorkUnit扫描、接受补丁重叠及驱逐决策时
npx skills add Kaelio/ktx --skill ingest_triage -g -y
从实时数据库快照中提取语义层和知识更新，通过读取原始JSON、连接元数据及外键信息，创建或更新语义层源，并执行严格的标识符验证协议以确保数据准确性。
需要处理 live-database 同步目录下的原始文件
需要将数据库表结构转换为语义层源定义
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从Looker运行时数据（仪表板、查询等）中提取指标公式和语义信息，验证实体并写入知识图谱或Wiki，实现业务知识的持久化与去重。
需要提取Looker仪表板或查询中的业务逻辑和指标定义
需要将Looker运行时数据转化为结构化的领域知识或语义层内容
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将LookML模型映射为ktx语义层源，支持Overlay和Standalone模式。包含字段映射、连接图转换及类型转换规则，并处理连接不匹配的硬限制检查。
用户请求将LookML转换为ktx格式
输入内容包含.lkml文件片段
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将Metabase的查询、模型和指标转换为ktx语义层源定义。处理元数据映射、主外键识别、去重及预聚合分解，并基于同步配置生成对应的数据结构。
工作单元包含Metabase卡片JSON文件
需要将BI分析对象转化为内部语义层格式
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数据模型规范和仪表板摘要提取并转换为持久的ktx wiki知识。处理data-models和workbooks单元，解析JSON结构以生成文档，不重写已生成的语义层YAML文件。
需要更新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语义层（SL）的结构化目录参考及查询方法。涵盖Overlay和Standalone源定义的YAML Schema，指导如何读取指标定义并通过sl_query工具查询预定义业务指标（如ARR、留存率等）。
需要查询预定义业务指标
理解或解析语义层YAML结构
使用sl_query工具进行数据检索
npx skills add Kaelio/ktx --skill sl -g -y
负责从对话或文档中捕获并持久化可复用的业务知识，如指标定义、过滤规则和领域约定。自动判断内容价值，避免存储过时数据，并通过搜索维护跨引用准确性。
用户提出需长期遵循的业务规则或指标定义
系统检测到可提取为持久化知识的上下文信息
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
