Agent Skills
› Kaelio/ktx
Kaelio/ktx
GitHub用于通过 ktx 连接查询数据库，执行数据探索、指标分析及 SQL 生成。支持语义层查询和原始 SQL，涵盖发现、计划、执行及验证全流程。
Install All Skills
npx skills add Kaelio/ktx --all -g -y
Skills in Collection (16)
用于通过 ktx 连接查询数据库，执行数据探索、指标分析及 SQL 生成。支持语义层查询和原始 SQL，涵盖发现、计划、执行及验证全流程。
需要查询数据库获取数据
数据分析请求如 'how many'
查看数据分解或对比时期
按值查找记录
npx skills add Kaelio/ktx --skill ktx-analytics -g -y
将 dbt YAML 元数据映射到 ktx 语义层覆盖层，处理模型、源、列描述及测试约束。需先通过仓库发现确认物理结构，再写入语义层或 wiki，避免凭空合成。
WorkUnit 的 skillNames 包含 dbt_ingest
检测到 models/ 或 sources/ 下的 dbt YAML 文件
npx skills add Kaelio/ktx --skill dbt_ingest -g -y
该技能用于将Google Drive中的文档转化为持久化的Wiki页面。通过读取原始文件、搜索现有内容并综合证据，提取政策、流程等业务知识，更新或创建Wiki条目，同时处理废弃路径决策，确保知识的复用性和准确性。
WorkUnit包含来自docs/**的Google Drive原始文件
需要将从Google Docs提取的内容整理为结构化知识库
npx skills add Kaelio/ktx --skill gdrive_synthesize -g -y
从历史SQL分析模式中识别跨表重复意图，并通过实体验证协议确保标识符准确性，最终生成标准化的模式证据对象以支持确定性Wiki内容构建。
需要分析历史SQL查询模式
从patterns-input数据分片中提取跨表分析意图
生成用于Wiki投影的结构化模式证据
npx skills add Kaelio/ktx --skill historic_sql_patterns -g -y
处理历史SQL表数据，提取使用证据并生成结构化Schema投影。通过验证标识符和解析查询模式，输出表格使用频率、过滤及关联信息，确保数据描述的准确性。
需要分析历史SQL查询中的表使用情况
从historic-sql适配器获取的表JSON文件需要转化为类型化的使用证据
npx skills add Kaelio/ktx --skill historic_sql_table_digest -g -y
处理数据摄入阶段的冲突，包括结构重复、定义矛盾及近重复聚类。通过决策树判断同批次或重摄场景，执行静默替换、标记或重命名策略，并负责Stage 4的驱逐操作。
数据摄入时检测到结构重复或定义矛盾
Stage 3/4 Agent 写入前发现与现有制品重叠
需要处理近重复聚类或执行驱逐决策
npx skills add Kaelio/ktx --skill ingest_triage -g -y
从实时数据库快照中捕获语义层和知识更新，处理表结构、外键及元数据，验证标识符并写入语义层源与Wiki页面。
工作单元包含 live-database 原始文件
需要构建或更新语义层数据源
需根据数据库注释生成文档
npx skills add Kaelio/ktx --skill live_database_ingest -g -y
从Looker运行时仪表板、查询和探索的JSON中提取度量公式、字段语义等知识，通过语义层工具写入持久化记忆，确保数据一致性与去重。
处理Looker运行时JSON文件
提取业务指标定义
同步数据字典到知识库
npx skills add Kaelio/ktx --skill looker_ingest -g -y
将LookML模型转换为ktx语义层源，支持Overlay和Standalone模式。自动处理映射、类型转换及连接校验，禁止非法写入，确保数据一致性。
包含.lkl内容
需要转换LookML到ktx语义层
npx skills add Kaelio/ktx --skill lookml_ingest -g -y
将 Metabase 查询、模型和指标转换为 ktx 语义层源定义。处理结果元数据到 KSL 列类型的映射，主外键检测，去重及关联图分析，并支持基于先验来源的同步响应逻辑。
需要转换 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 知识。处理 staged 目录下的 JSON 文件，区分仓库表和衍生视图，写入语义层或 Wiki，不重写已生成的 SL 源文件。
接收到 sigma-data-models 或 sigma-workbooks 工作单元
需要提取并持久化 Sigma 平台的数据模型和报表元数据
npx skills add Kaelio/ktx --skill sigma_ingest -g -y
指导如何将可复用的业务指标、维度或连接模式捕获到语义层目录中，强调通用性与SQL方言适配，避免冗余硬编码。
用户生成可复用的业务指标或计算逻辑
发现缺失的多表连接模式
需要创建通用的聚合度量
npx skills add Kaelio/ktx --skill sl_capture -g -y
介绍ktx语义层（SL）的结构化目录，涵盖源定义、度量和查询方法。用于通过sl_query获取ARR等预定义业务指标，或读取SL YAML理解数据目录，是研究和分析的核心技能。
查询预定义业务指标如ARR、留存率
读取语义层YAML以理解数据目录结构
npx skills add Kaelio/ktx --skill sl -g -y
负责从对话或文档中提取持久化业务规则、指标定义及组织惯例，存入知识库。通过判断内容价值并建立交叉引用，确保知识复用性，避免存储过时数据。
用户定义业务指标或过滤规则
提供跨系统映射或别名约定
外部文档导入需提取持久化常识
npx skills add Kaelio/ktx --skill wiki_capture -g -y
用于自动化安装和配置 ktx 数据代理上下文层，包括连接数据库、嵌入模型及代理集成。支持非交互式设置、凭证管理及故障排查，确保本地环境就绪。
用户要求添加 ktx 到项目
需要连接数据源或构建初始上下文
安装代理集成规则
导入 Schema 数据
排查本地 ktx 安装问题
npx skills add Kaelio/ktx --skill ktx -g -y
