用途:在已有 MotherDuck 数据上构建一个可保存、可分享的 Dive 仪表盘,围绕一个清晰的分析故事组织 KPI、趋势和拆解视图。这是一个用例型技能,会编排 explore、query、create-dive 和 duckdb-sql。
主要能力:先确认是否有可用的 MotherDuck 服务器(远程 MCP 或本地),再探索真实数据模型(表与视图、业务粒度、关键指标、关键维度、日期列、可能的连接),据此决定仪表盘故事与分区。默认结构为:一个故事、一行 KPI、一张主趋势图、零或一张辅助图、零或一张明细表,重整形在 SQL 而非 React 中完成。
使用方式:确认实时发现是否可用;若目标数据库不明确,先询问数据库或工作区;探索真实 schema 与指标;选定故事;每个分区写一条查询;在 Dive 中组合;预览迭代通过后再保存。若产生原生 DuckDB(md:)连接,需用 custom_user_agent=agent-skills/<latest-available-skills-version>(harness-<harness>;llm-<llm>) 打水印,元数据缺失时回退为 harness-unknown 和 llm-unknown。
输出:仪表盘故事、分区列表、各分区已验证 SQL、Dive 实现计划、保存/更新路径。若调用方明确要求结构化 JSON,则只返回顶层为 summary、assumptions、implementation_plan、validation_plan、risks 的原始 JSON,不加 Markdown 围栏或前后文字。
适用场景:需要在一个产物中同时呈现 KPI、趋势与拆解;结果应为可保存分享的 Dive;属于工作区分析界面而非面向客户的产品后端。更底层的 Dive 机制请用 create-dive。
限制:无服务器时需用户提供表清单或 schema 片段,并显式说明假设。参考资料包括 references/DASHBOARD_IMPLEMENTATION_GUIDE.md、references/DASHBOARD_PATTERNS.md,以及可运行示例 artifacts/dashboard_story_example.py 与 .ts。运行示例:uv run --with duckdb python skills/build-dashboard/artifacts/dashboard_story_example.py;对临时 MotherDuck 数据库运行:MOTHERDUCK_ARTIFACT_USE_MOTHERDUCK=1 uv run --with duckdb python skills/build-dashboard/artifacts/dashboard_story_example.py;验证 TypeScript 示例:uv run scripts/test_typescript_artifacts.py。