chdb-sql

注册 chdb-datastore 和 chdb-sql 技能并同步描述 (#35)

添加 chdb 技能：DataStore（pandas API）和 SQL (#14) ## 摘要 - 添加 **chdb-datastore** 技能：面向 [chdb](https://clickhouse.com/docs/chdb) 的 Pandas 兼容 DataStore API。由 ClickHouse 支持的 pandas 直接替代品 （`import chdb.datastore as pd`），支持 16+ 种 数据源（MySQL、PostgreSQL、S3、MongoDB、ClickHouse、Iceberg、Delta Lake 等）和 10+ 种文件格式，并支持跨源连接。 - 添加 **chdb-sql** 技能：面向 Python 的进程内 ClickHouse SQL API。 涵盖 `chdb.query()`、Session、DB-API 2.0、参数化查询、UDF、 流式处理以及所有 ClickHouse 表函数。 - 更新根目录 `README.md` 和 `AGENTS.md` 以包含新技能。 ## 技能结构 每个技能都遵循 agent-skills 格式，包含： | 文件 | 用途 | |------|---------| | `SKILL.md` | 技能定义，包含 YAML frontmatter 和快速开始 | | `metadata.json` | 版本、组织、摘要 | | `README.md` | 维护者指南，包含触发短语 | | `references/*.md` | API 参考和函数文档 | | `examples/examples.md` | 可运行示例及预期输出 | | `scripts/verify_install.py` | 环境验证脚本 | ## 为什么是两个技能？ 这些技能按使用模式拆分，以便 agent 只加载 相关内容： - **chdb-datastore** 在 pandas 风格数据分析（filter、 groupby、join、sort —— 与 pandas 相同的 API）时激活 - **chdb-sql** 在原始 SQL 查询（ClickHouse 表 函数、窗口函数、会话、UDF）时激活 两者在各自的 SKILL.md 中相互交叉引用，以便 agent 知道 何时切换。 ## 测试计划 - [x] 验证 `SKILL.md` frontmatter 能正确解析（name、description、 license、metadata 字段） - chdb-datastore：name=chdb-datastore，license=Apache-2.0， author=chdb-io，version=4.1 - chdb-sql：name=chdb-sql，license=Apache-2.0，author=chdb-io， version=4.1 - [x] 验证 SKILL.md 中的所有内部链接都能解析到其参考 文件 - chdb-datastore：7 个链接（references/connectors.md、 references/api-reference.md、examples/examples.md、 scripts/verify_install.py）—— 全部解析成功 - chdb-sql：7 个链接（references/table-functions.md、 references/sql-functions.md、references/api-reference.md、 examples/examples.md）—— 全部解析成功 - [x] 在两个技能目录中运行 `python scripts/verify_install.py` （需要 `pip install chdb`） - chdb-datastore：8/8 项检查通过（import chdb、from datastore import DataStore、from chdb.datastore import DataStore、import chdb.datastore as pd、filter、sort、groupby） - chdb-sql：6/6 项检查通过（import chdb、基本查询、DataFrame 输出、Session、参数化查询） - [x] 通过 `npx skills add` 安装技能，并验证 agent 在 触发短语时激活 - `npx skills add auxten/agent-skills --list` 正确检测到全部 3 个 技能（chdb-datastore、chdb-sql、clickhouse-best-practices） - `npx skills add --all` 通过 符号链接将 3 个技能安装到 42 个 agent 目录 - 验证 `.claude/skills/`、`.windsurf/skills/` 等包含正确的 符号链接 - 生成的 `skills-lock.json` 具有正确的 source 和 hashes --------- Co-authored-by: Copilot Autofix powered by AI