motherduck-build-dashboard

构建分析仪表板

从这里开始：MotherDuck 服务是否处于活动状态？

使用活动的远程 MotherDuck MCP 服务或本地 MotherDuck 服务，检查范围内的数据库、架构、粒度、键和相关指标。复用已知上下文，并将探索范围限定在所请求的工作内；默认不要扫描整个工作区。根据实际数据模型塑造结果。

根据请求或当前上下文确定目标。只有当歧义会实质性影响结果时才提问。没有服务时，使用提供的架构和明确的假设进行规划；不要暗示已进行实时验证。

仪表板默认设置

• 每个仪表板讲述一个故事。
• 从响应式 KPI 组、主图表，以及有助于决策的辅助详情开始。只有当问题或数据需要时才添加其他部分；这些是默认设置，并非固定的图表配额。
• 在 SQL 中进行繁重的数据处理，而非 React。
• 当仪表板应触发某项操作（批准、刷新、提交）时，添加一个运行 Flight 的回写按钮；参见 motherduck-create-dive。
• 查看者可以通过 Dive 的 AI Chat 提出后续问题，因此请使用业务术语命名各个部分和指标。

工作流

1. 检查可用的 MotherDuck 服务或提供的架构上下文。
2. 阅读相关的根级/领域 Guides，然后探索实际架构并验证受治理的指标。
3. 确定仪表板要讲述的故事。
4. 为每个部分编写一个查询。
5. 对于新建仪表板或布局变更，使用 motherduck-design-dive 中的响应式和主题指南；对于范围明确的 SQL 或文本编辑，保留现有设计。
6. 在 Dive 中构建仪表板。当 MotherDuck MCP 可用时，编写 Dive 代码前，以及每次调用 save_dive 或 update_dive 前，都调用 get_dive_guide。
7. 当请求包含创建或更新 Dive 时，只有在完成响应式、主题、查询状态和数据验证后才保存；对于所请求范围内的写入，不要额外增加第二道审批关卡。
8. 读取已保存的 Dive。将进行中的工作保留为 Draft；只有在验证所请求的交付内容后，才将其提升为 Ready。重建现有的可信答案前，先复用 Endorsed Dives。

让执行方式与请求相匹配：回答、审查或规划类工作应返回所请求的仪表板产物；构建或变更类工作应创建或更新所请求范围内的 Dive，并进行验证。对于破坏性替换、无关的外部写入或实质性扩大范围，先征求确认。

当此技能生成原生 DuckDB (md:) 连接时，使用 custom_user_agent=agent-skills/2.6.0(harness-<harness>;llm-<llm>) 为其添加标识。如果缺少元数据，则回退使用 harness-unknown 和 llm-unknown。

输出

对于完整的项目，根据请求覆盖以下相关内容：

• 仪表板要讲述的故事
• 各部分列表
• 每个部分经过验证的 SQL
• Dive 实施计划
• 保存/更新路径

对于明确要求结构化 JSON 的请求，请阅读输出约定。否则，使用适合所请求交付内容的格式。

参考资料

只阅读与任务相关的章节；这些内容是指导，而非必须遵循的固定流程。

• references/DASHBOARD_IMPLEMENTATION_GUIDE.md -- 从部分映射到 SQL、TSX 组合方式和验证示例
• references/DASHBOARD_PATTERNS.md -- 仪表板组合示例和可复用部分

示例

仅在运行打包示例或复现其验证时，才阅读执行参考。

• dashboard_story_example.py
• dashboard_story_example.ts

相关技能

仅在缺少相应能力时加载相关技能；复用已有上下文。

• motherduck-explore —— 在确定仪表板各个区块前，检查实际数据库
• motherduck-query —— 验证每条仪表板查询
• motherduck-create-dive —— 使用 SQLQuery、主题设置、预览和保存、加载及可视化机制
• motherduck-design-dive —— 响应式布局、筛选器容量、浅色/深色令牌、可复用组件及视觉质量检查
• motherduck-duckdb-sql —— 解答语法和函数相关问题