SuperAPI AI 工具集

initializing-warehouse

数据与分析

查看项目

更新于 10-15 17:20

技能介绍

用途:初始化数据仓库模式发现,生成团队可共享、可版本控制的仓库结构参考文件 .astro/warehouse.md,方便快速查找概念对应的表,减少直接查询仓库。

主要能力:读取 ~/.astro/ai/config/warehouse.yml 获取已配置数据库(如 HQ、ANALYTICS、RAW);通过 list_schemas、list_tables、get_tables_info 等工具发现库、模式、表和列,记录行数并标记大表(>100M 行);并行搜索代码库中的 dbt 模型、gusty SQL frontmatter、AGENTS.md 或 CLAUDE.md 等上下文,补全表描述与主键;为关键分类列发现取值族;生成含 Quick Reference、分类列、数据层体系、表详情和关系的 Markdown 文件,并缓存概念映射。

使用方式:执行 /data:init 生成文件;可加 --refresh 保留用户编辑后重生成,--database HQ 限定数据库,--warehouse prod 指定仓库,--global 写入 ~/.astro/ai/config/,--no-code 跳过代码库搜索。多仓库时默认发现第一个,可用 --warehouse 指定。生成后可选将 Quick Reference 追加到 CLAUDE.md。

适用场景:需要快速理解或查询数据仓库、为复杂数据查询提供表映射、在团队间共享模式参考、随模式变更刷新元数据。

限制:缓存默认 7 天 TTL,过期需重新发现;模式变更后应运行 --refresh;查询失败、结果异常或新表未被发现可能表示缓存过期。具体价格、平台支持细节暂未提供。