ktx · Skills Scout

1. 基本信息

项目	内容
名称	ktx
作者/维护者	Kaelio（Y Combinator 孵化团队，创始人 Luca Martial、Andrey Avtomonov）
来源链接	https://github.com/Kaelio/ktx
许可证	Apache-2.0（GitHub API 确认，字段明确非 NOASSERTION）
GitHub Stars / Forks	1503 / 94（GitHub API 实测）
最新版本	npm `@kaelio/ktx` 0.16.0（2026-07-03 发布，npm 注册表确认，累计 25 次发布）
安装方式	一条命令：`npx skills add Kaelio/ktx --skill ktx`（详见第 10 章）

2. 功能介绍与亮点

ktx 是面向数据/分析 agent 的“可执行上下文层”：让 Claude Code、Codex 等 agent 查询数据仓库时复用审核过的指标定义，而不是每次现造 SQL、每次重新探索表结构。

自动构建语义层：采样表结构、识别可连接列，自动化解决连表歧义，把原始表与高层指标组织成一张 join 图
吸收公司知识：摄取 wiki、Notion 等文档，自动去重整理，并标记矛盾之处交给人工复核
纯文本落地：语义层与知识库均以 Markdown/YAML 文件形式写入项目仓库，可以像代码一样走 PR 评审、diff、合并
面向 agent 执行：同时暴露 CLI 与 MCP 工具，支持全文 + 语义混合检索
只读设计：agent 通过语义层生成的 SQL 默认只读执行
广泛数据源支持：Postgres、Snowflake、BigQuery、ClickHouse、MySQL、SQL Server、SQLite、DuckDB、Amazon Athena、MongoDB 等仓库，以及 dbt、MetricFlow、LookML、Looker、Metabase、Sigma、Notion、Google Drive 等数据/知识源

主要亮点：Y Combinator 孵化团队出品，Apache-2.0 完全开源可自托管运行，CI 测试与 Codecov 覆盖率徽章公开可查；开源版本功能完整、无强制付费依赖，可选的 ktx Cloud 托管版本只是额外的多用户协作层。

3. 适用场景

所属分类：数据分析与可视化

适合已经在用 Claude Code、Codex 等 agent 做数据分析、但发现 agent 每次都重新摸索表结构、编造指标口径、同一问题多次得到不一致答案的团队；业务知识分散在 dbt、Looker、Metabase、Notion 等多个工具里、缺一个统一入口喂给 agent 的公司；需要给 agent 一层“只读、可审计”数据访问护栏、又不想为每次查询手写语义层的数据/分析工程师。官方文档明确说明：如果没有 SQL 数据仓库、或只是想跑一次性查询，不需要用 ktx。

4. 跨 Agent 兼容性

Claude Code：原生支持——SKILL.md 直接为其编写安装流程（--llm-backend claude-code 参数），README 提供一句话安装指令
Codex：原生支持——README/SKILL.md 明确列出 --target codex 安装路径
OpenClaw：未验证——官方材料未提及该平台
Hermes Agent：未验证——官方材料未提及该平台

以上判断仅基于已抓取的仓库文档，未为兼容性单独发起搜索。补充：官方材料另提及 Cursor、OpenCode 也受原生支持。

5. 推荐理由

多数“给 agent 接数据”的方案要么让 agent 每次直接连库现场探索（慢、易编错指标），要么依赖传统语义层需要人工持续手写和维护建模语言。ktx 把两者优点结合：自动从仓库、BI 工具与公司文档构建语义层和知识 wiki，agent 复用审核过的指标定义而非每次重新发明，且所有生成物都是可 review 的纯文本文件。对于已经用 Claude Code/Codex 做数据分析、又常被 agent“编造口径”困扰的团队，这是一层性价比很高的准确性护栏。

6. 评分

维度	分数	说明
受欢迎程度	8	GitHub 1503 星，Show HN 帖 93 points 且有实质技术问答；GitHub issues 中有具名外部公司工程师（Sigma Computing）贡献新连接器，多个独立来源均有活跃讨论
可用性	8	`npm install -g @kaelio/ktx` 或 `npx skills add` 一条命令安装；SKILL.md 步骤详尽、含故障排查文档；近 2 个月内发布 25 个 npm 版本，最近一次推送在近一周内；需连接自有数据仓库与 LLM 后端，需要少量配置
安全性	8	逐项检查：①shell 命令限于本地 CLI 操作（npm 安装、ktx setup/ingest/mcp），权限范围清晰；②运行时会将仓库元数据/文档发往用户自选的 LLM 后端用于构建上下文，属核心功能且文档透明说明，数据库查询默认只读；③要求数据库与 LLM API 凭据，SKILL.md 明确要求使用 `file:` 引用+`chmod 600`、不提交密钥，处理规范优于同类项目；④SKILL.md 与脚本通读未发现可疑指令；⑤Y Combinator 孵化团队，创始人在 GitHub issue 与 Hacker News 均以真实身份活跃回应；⑥Apache-2.0 许可证明确；⑦最近一次推送在一周内，维护活跃

综合评分：8.0

7. 跟同类 Skills 相比的优势

项目	定位	与 ktx 的差异
Wren（Wren AI Engine）	开源文本转 SQL/语义层引擎，需人工编写 MDL 建模语言，由自有 Rust 引擎执行查询	ktx 从既有仓库、BI 工具与文档自动构建语义层，不要求预先手写建模语言；两者在 Hacker News 讨论中被 ktx 维护者本人列为同类项目
dbt Metrics / MetricFlow	传统语义层代表，指标定义需持续人工维护	ktx 自动吸收 wiki/Notion 等公司知识、自动检测可连接列并标记矛盾，减少人工维护负担
data-goblin/power-bi-agentic-development（798★，聚合于整个插件合集）	专注 Power BI/Microsoft Fabric 单一 BI 平台的技能与 subagent 集合，含语义模型、DAX、TMDL、分页报表等 11 个子插件	ktx 面向通用 SQL 数仓（Postgres/Snowflake/BigQuery/ClickHouse 等）与多种 BI/文档源，不绑定单一 BI 厂商

8. 用户评价

Hacker News「Show HN」讨论（news.ycombinator.com/item?id=48309986，93 points）：用户 tarun_anand 询问与 Wren、OpenVikings 的区别，维护者 andreybavt、lucamrtl 逐一说明架构差异；用户 modus-tollens 追问准确率评测方法，维护者回应正在做 Spider 2 基准提交；用户 banditelol 建议增加查询沙箱机制，维护者说明其“从源头避免生成错误查询”的设计思路并已提供预置体验项目。
GitHub Issue #316（Kaelio/ktx#316，10 条评论）：Sigma Computing 工程师 mattsenicksigma 实际部署测试并贡献 Sigma 连接器，与维护者 andreybavt 经过多轮代码评审、逐条修改后合入，维护者表示会在官方博客介绍这次贡献。

9. 其他补充

项目提供中文之外的多语言支持信息未见披露；社区渠道为官方 Slack（README 内提供邀请链接）；除开源自托管版本外，另有付费的 ktx Cloud（托管运行时、多用户协作、SSO、持续摄取）与“托管 Data Agent”选项，不在本次评测范围内。

10. 安装使用方式

推荐方式（一条命令，安装进当前项目并自动适配 Claude Code / Codex / Cursor / OpenCode）：

npx skills add Kaelio/ktx --skill ktx

直接安装 ktx CLI 本体：

npm install -g @kaelio/ktx
ktx setup
ktx status

安装后注意事项：

需要 Node.js ≥ 22
ktx setup 完成后需另外运行 ktx mcp start --project-dir <path>，agent 集成才可用（SKILL.md 原文强调“Required before using agents”）
需要准备一个可连接的 SQL 数据仓库（Postgres/Snowflake/BigQuery/ClickHouse/MySQL/SQL Server/SQLite/DuckDB/Athena/MongoDB 之一）和一个 LLM 后端；在 Claude Code 内可直接复用 Claude Pro/Max 登录态，无需额外计费

11. 注意事项

当前 npm 包版本 0.16.0，尚未到 1.0，接口可能变动
需自备可连接的数据仓库；官方 README 明确写明“没有 SQL 数据仓库、或只想跑一次性查询”不适用本工具
OpenClaw、Hermes Agent 的兼容性未经验证
开源版本本地自托管运行，需自备 LLM API Key 或 agent 登录态；ktx Cloud 为另收费的托管服务，非开源版本必需项