1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | databricks-apps(Databricks 官方 Agent Skills 合集子技能) | GitHub API |
| 作者/维护者 | Databricks 官方账号;子目录由 11 位工程师跨约 5 个月共同提交维护 | GitHub API(commits) |
| 来源链接 | https://github.com/databricks/databricks-agent-skills/tree/main/skills/databricks-apps | — |
| 许可证 | Databricks 自定义平台许可证(仓库 LICENSE 文件明确写明;非标准开源协议,限定 Databricks 服务场景内使用) | 网页抓取(LICENSE 原文) |
| GitHub Stars / Forks | 235 / 67(整个合集仓库口径,覆盖 29 个子技能,本子技能自身不单独计星) | GitHub API |
| 最新版本 | v0.2.10(仓库级 Release,2026-07-16 发布) | GitHub API |
| 安装方式 | 官方 databricks aitools install CLI / Claude Code・Codex 插件市场 / 手动复制目录 |
网页抓取(README) |
2. 功能介绍与亮点
databricks-apps 教 AI 编程助手在 Databricks Apps 平台上正确搭建全栈数据应用:先给出“该用托管 AI/BI 仪表盘还是自建应用”的决策指引,避免过度工程;再针对读数据场景给出“走 SQL 仓库分析查询”还是“走 Lakebase 同步表做低延迟查询”的选型对照表;覆盖 AppKit(TypeScript/React 框架)脚手架、Genie 自然语言问答面板、模型推理调用、Lakeflow 任务触发、Unity Catalog Volumes 文件管理等全部数据面场景,并附带真实踩坑细节(如冒烟测试载荷超 1MB 会导致 UI 断言全部失败、appkit lint 禁止的双重类型断言写法)。技能自带 agents/openai.yaml 适配文件,是比 README 泛泛而谈更具体的 Codex 兼容性证据。技能要求先装同仓库的入口技能 databricks-core 处理认证与画像选择。
3. 适用场景
固定分类:数据分析与可视化。适用于已有 Databricks 工作区、需要为业务团队自助搭建数据应用(KPI 看板、自定义交互界面、Genie 对话式查询面板、需要写回的运营工具)的数据工程师与 AI 应用工程师;尤其适合那些“托管仪表盘做不到”的场景——需要自定义交互组件、写回操作、鉴权网关或嵌入式对话界面。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 提供
/plugin marketplace add databricks/databricks-agent-skills+/plugin install databricks@databricks-agent-skills - Codex:✅ 原生支持——README 单列
codex plugin marketplace add+codex plugin add databricks安装步骤,且本子技能自带专属agents/openai.yaml适配文件 - OpenClaw:未验证——抓取材料中未出现相关声明
- Hermes Agent:未验证——抓取材料中未出现相关声明
(仓库同时提供 Cursor、GitHub Copilot 的官方安装路径,因不在本项目服务的四个 agent 生态范围内,仅作背景信息)
5. 推荐理由
Databricks 官方把“该建仪表盘还是建应用”“该走分析查询还是走低延迟同步表”这类容易凭直觉做错的架构决策,提炼成决策门与对照表塞进技能里,配合真实生产踩坑记录的详细指引,帮助 AI 助手在 Databricks Apps 平台上一次性搭对数据应用骨架,而不是生成一版能跑但选型错误、后续要推倒重来的代码。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 子目录自身 41 次提交、11 位不同工程师跨约 5 个月持续迭代,56 个 PR 提及该技能;GitHub issue 显示真实外部依赖——第三方用户报告 Cursor Marketplace 插件版本滞后、另一用户通过 APM 包管理器将其列为显式技能依赖安装进 GitHub Copilot 环境;独立第三方(Databricks MVP 在 Hiflylabs 撰文)专门称赞其“应用平台防护栏”能力 |
| 可用性 | 9 | SKILL.md 逾 200 行 + 6 篇分主题参考文档(AppKit SDK、Lakebase、Genie、模型服务、任务触发、测试指南),文档含大量真实报错信息与规避写法;子目录最近一次提交 2026-06-23,在近 3 个月维护窗口内;需预装 Databricks CLI(≥ v0.294.0)与入口技能 databricks-core,非零配置 |
| 安全性 | 9 | 技能目录内仅含 SKILL.md、YAML 适配文件与静态参考文档,无任何嵌入式可执行脚本;引导 AI 助手调用官方 databricks CLI 与 npx @databricks/appkit 等标准工具链完成脚手架与校验,无自定义联网上报代码;凭据通过入口技能 databricks-core 的 OAuth/PAT 画像机制存储,非明文;License 在 LICENSE 文件中明确写明,虽为 Databricks 自有条款而非通用开源协议,但条款清晰可查 |
综合评分(三项均值):8.33
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| databricks-core(同仓库入口技能) | 处理 CLI 认证、画像选择、资源枚举与 schema 探索 | 是本技能的前置依赖,只管“连上 Databricks”,不涉及应用脚手架、前端组件选型或部署校验 |
| Snowflake-Labs/coco-skills | Snowflake 官方 Cortex Code(“CoCo”)CLI 配套技能集 | 仓库刚起步(个位数 star,无 LICENSE 文件),尚未形成databricks-apps 这类经过真实生产踩坑打磨的详细指引 |
| databricks-lakebase(同仓库姊妹子技能) | 专攻 Lakebase(Databricks 托管 OLTP Postgres)连接与分支管理 | 只覆盖数据库这一单一后端能力,不含前端框架脚手架、部署校验与决策门设计 |
8. 用户评价
GitHub 仓库可查证到多起真实外部使用反馈:用户 jgleicher-sd 提交 issue(#215)指出 Cursor Marketplace 插件版本滞后于主仓库(marketplace 仅显示 10 个技能,主仓库已发布含 29 个技能的 v0.2.10 版本);用户 francho-plain 提交 issue(#226)报告用 APM 包管理器为 GitHub Copilot 目标环境安装本仓库时,apm.yml 中显式声明了对 databricks-apps 等技能的依赖,安装过程触发了钩子路由相关警告。独立第三方评价来自 Databricks MVP、Hiflylabs 顾问 Domonkos Pál 的技术博客,评价该技能集“最强的部分是其应用平台防护栏,涵盖端口绑定规则、权限自动授予、OBO 范围和部署正确性细节”,并将其定位为“最适合任何需要官方支持、强 Databricks 指导的团队”。
9. 安装使用方式
- 官方 CLI(推荐):
databricks aitools install databricks-apps,自动探测已安装的 agent 并装入对应技能目录 - Claude Code 插件市场:
/plugin marketplace add databricks/databricks-agent-skills后/plugin install databricks@databricks-agent-skills(安装整个合集,含本技能) - Codex 插件市场:
codex plugin marketplace add databricks/databricks-agent-skills后codex plugin add databricks,安装后需执行/hooks确认插件钩子 - 手动安装:直接复制仓库
skills/databricks-apps/目录到对应 agent 的技能目录 - 安装后无需重启;首次使用前需先完成
databricks auth login工作区认证(由前置技能 databricks-core 处理),技能会在缺少画像时主动提示而非自动猜测账号
10. 注意事项
- 依赖同仓库入口技能
databricks-core完成认证,两者需配套安装 - 需要一个可用的 Databricks 工作区账号;无 Databricks 账号的用户无法使用本技能
- 许可证为 Databricks 自定义平台协议而非标准开源许可,使用场景被限定在“连接 Databricks 服务”范围内
- OpenClaw、Hermes Agent 的兼容性未获官方声明,跨 agent 使用前建议自行验证 SKILL.md 能否被目标 agent 正确加载
- Cursor Marketplace 渠道的插件版本曾被社区反馈滞后于主仓库发布节奏(issue #215),通过官方 CLI 或 Claude Code/Codex 插件市场安装可避免此问题