SuperAPI AI 工具集

lakebase-scm-workflows

办公与效率

查看项目

更新于 10-16 05:05

技能介绍

用途:在 Databricks Lakebase 项目中将 Lakebase 分支与 git 分支成对管理,覆盖从项目脚手架到功能分支、PR、CI、合并的完整流程。该技能需先加载父级 databricks-lakebase 技能获取 Postgres CLI 基础。\n\n主要能力:提供五状态机(scaffold-complete → feature-claimed → pr-ready → ci-green → merged),状态存于 .lakebase/workflow-state.json。CLI 包括 lakebase-scm-state(只读检查)、lakebase-scm-doctor(交叉诊断)、lakebase-scm-claim-feature-branch(启动功能)、lakebase-scm-prepare-pr、lakebase-scm-wait-ci、lakebase-scm-merge 等,均支持 --project-dir、--json、--pretty。分支操作有 lakebase-branch 的 list/show/create/delete/create-paired/delete-paired/checkout-paired/sync-env/create-tier 子命令,也提供 MCP 工具。另有 git hooks(post-checkout、post-merge、pre-push、prepare-commit-msg)自动同步 .env 凭据与迁移。\n\n使用方式:在已有配对项目里,读 .env 中 LAKEBASE_PROJECT_ID 推导实例;git checkout 后调用 syncEnvToCurrentBranch 使 .env 匹配分支。新建项目用 lakebase-create-project 生成脚手架与 .env。每个功能周期依次执行 claim、编码测试、prepare-pr、wait-ci、merge。纯 API 会话可显式传 instance 和 branch,无需 .env。\n\n限制:处于 alpha.45 阶段。删除分支非幂等,找不到即抛错;production/main/master 受保护,除非显式传 allowProtected。Phase C 起,git checkout -b 不再自动创建 Lakebase 分支,必须走 substrate 路径。后续功能如 CI 等待与 doctor --fix 尚未提供。内部版本与实现细节可能变化,具体请以官方文档为准。