用途:根据提示词生成可运行的 CARTO + deck.gl 地理空间应用,按四个决策(应用类型、框架、鉴权模型、数据形态)组装图层、控件、过滤器、输入、图例,并可选内嵌地图智能体。适用于“deck.gl app”“CARTO app”“map app”“spatial dashboard”等场景;提供 Builder 地图 ID 时走 fetchmap,故事地图走 storymap,聊天式地图走 agentic-variant。
主要能力与用法:基于 CartoDB/deck.gl-examples 蓝图;图层来自 @deck.gl/carto,数据源、控件、过滤器、fetchMap、query() 来自 @carto/api-client(v0.4.0 起数据源不再从 @deck.gl/carto 导入)。默认自主生成环境,不采访用户:先运行 carto auth status --json 获取 apiBaseUrl,carto connections list --json 获取 connectionName(默认 carto_dw),再创建令牌,例如 carto credentials create token --json --connection <connectionName> --source <fully.qualified.table.A> --connection <connectionName> --source <fully.qualified.table.B> --apis sql,maps --referers 'http://localhost:5173*,<production-origin>*'。私有应用改用 carto credentials create spa --json(OAuth)或 carto credentials create m2m --json。演示默认 vanilla TS + Vite + MapLibre,生产/鉴权/部署/多屏用 React,Vue/Angular 仅在明确指定时使用。最后运行 npm install && npm run dev 并报告 URL。
限制:这是 CLI 路径技能,脚手架与运行需要真实 shell 与开发环境(npm、Vite),没有 MCP 工具能生成应用,因此无法在沙箱聊天环境(Claude.ai、ChatGPT)运行;只有凭据/发现步骤有 MCP 等价物。public token 必须带 --source 并限制 --apis 为 sql,maps,公共包中不得使用 imports / lds。复杂分析(预测、评分、分群、多步连接)应做成 workflow 而非应用内 SQL。图层 z 序由 layers 数组决定,需传新数组而非原地修改。视口空间过滤器在 onViewStateChange 上约 300ms 防抖。不得编造 logo,仅在有已验证资源时渲染。若 carto 不在 PATH 或鉴权失败,应说明一次并停止。