SuperAPI AI 工具集

build-cfa-app

数据与分析

查看项目

更新于 10-16 01:20

技能介绍

用途:当需要把分析能力嵌入产品、面向外部用户提供嵌入式或产品级分析时,用此技能产出具体的服务架构,而不仅是仪表盘。它属于用例型技能,会编排 connect、explore、model-data、query、load-data 等环节。

主要能力:先确认是否有可用的 MotherDuck MCP 远程服务器或本地服务器;若有则先探查实时数据模型(数据库与 schema、表与视图、列与类型、连接键、时间维度、核心服务指标),再据此确定服务模式、租户边界与示例代码。默认服务选择为三层架构:浏览器 -> 后端 API -> MotherDuck。只读且仅需实时仪表盘界面时可接受嵌入式 Dive;DuckDB-Wasm 仅适用于小型、浏览器端、只读负载;单一共享 tenant_id 过滤只是兜底方案。

使用方式:确认实时发现是否可用;探查实际数据模型;选择服务模式(三层应用、嵌入式 Dive、纯浏览器原型);设计隔离模型(按客户数据库、按工作负载或服务账号边界);选择连接路径与读扩展姿态;产出实施计划、API 契约与上线顺序。若生成原生 DuckDB(md:)连接,需按资料要求添加 custom_user_agent 水印,元数据缺失时回退为 harness-unknown 与 llm-unknown。

输出:推荐的服务架构、隔离模型、连接策略、首个实现切片、验证与上线计划。若调用方明确要求结构化 JSON,则仅返回顶层为 summary、assumptions、implementation_plan、validation_plan、risks 的原始 JSON。

适用场景:需要嵌入式或产品级分析、租户隔离或爆炸半径重要、读并发与延迟重要、需要后端契约而非仅 Dive、要求强于内部仪表盘或只读嵌入。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;无实时服务器时需用户提供代表性 schema 片段或表列表,并保持假设显式。可运行示例包括 artifacts/customer_routing_example.py 与 .ts,运行命令为 uv run --with duckdb python skills/build-cfa-app/artifacts/customer_routing_example.py,使用临时 MotherDuck 数据库时加 MOTHERDUCK_ARTIFACT_USE_MOTHERDUCK=1,TypeScript 校验命令为 uv run scripts/test_typescript_artifacts.py。