用途:为自定义代码 Databricks Apps(AppKit/React)的数据界面做设计或评审,包括概览/KPI 页、报表、指标/本体页、差异分析、图表、表格,以及 Genie/自然语言数据界面。不适用于编写托管 AI/BI(Lakeview)仪表盘、通用前端(表单、认证、设置、营销),也不负责脚手架、构建与部署;纯“创建/构建仪表盘”请求指向 Lakeview,不触发本技能。databricks-apps 负责构建运行,本技能决定数据界面长什么样、用哪些原语实现。
主要能力:按工作流推进——框定受众、决策问题、刷新频率、设备与主任务;从 dashboard-patterns.md 选定体裁;组合内容与布局并说明取舍;应用 IBCS 记法规则(标题即信息、场景标记、诚实刻度、语义色);把每个元素映射到 @databricks/appkit / @databricks/appkit-ui 实际导出的组件,不引用 AppKit 未提供的组件,用 colorPalette 与语义 token 而非硬编码颜色,用 useAnalyticsQuery/queryKey + sql.* 绑定数据。
数据状态要求:加载用 Skeleton,空态给下一步操作,错误内联提示,部分/过期数据展示已有内容并注明新鲜度;每个 KPI 显示单位、周期、对比与来源;大表用服务端分页/排序/过滤;长查询做乐观加载与超时错误处理。
AI/Genie 界面:仅当应用存在 Genie/对话/自然语言入口时适用,需全部实现身份(/api/whoami 与已登录用户 Badge,并如实说明 OBO 或服务主体)、可检查的生成 SQL、反映 useGenieChat().status 的流式状态、每次回答的“AI 生成,请核实”提示,以及治理与空/错误/歧义处理。
输出形式:设计提案分方向、模式与记法、组件计划、取舍与风险;评审先给最高影响的理解或诚信问题并标注组件/文件。
限制:禁止在没有组件计划时给出设计备忘录;不得只说“用语义色”而不指明 token;不得虚构 AppKit 组件;避免过度设计;不得遗漏加载/空/错误状态或 KPI 的来源与新鲜度。安装命令与更多参考文件内容官方文本未提供。