SuperAPI AI 工具集

setup

部署与运维

查看项目

更新于 10-30 16:30

技能介绍

用途 该技能的目标是让仓库的每个新工作区(独立的 git worktree)在创建后即可使用:依赖已安装、环境变量已就位、服务可访问,无需手动步骤。

主要能力

  1. 检查仓库:确认新 worktree 需要什么,并对不明确之处提问。检查内容包括包管理器与安装命令(由锁文件决定 bun/pnpm/yarn/npm、cargo、uv 等)、环境文件(.env 通常被 gitignore,需要从主检出复制或由 .env.example 生成)、服务(docker-compose、数据库)与开发命令及端口、monorepo 布局(setup 是否需要指定 cwd)。
  2. 编写 .superset/config.json:该文件用于接入生命周期脚本;仅有 setup.sh 而没有 config.json 不会被识别。配置结构为:setup、teardown、run 三个键各为 shell 命令数组,分别在创建、删除、运行时于 worktree 内执行;可选 cwd 指定子目录。写入前会向用户展示拟生成的文件并取得明确批准。
  3. 实际验证:用 superset workspaces create --local --project <id> --name "setup-test" 创建一次性工作区,观察 "Workspace Setup" 终端输出,修复并重复,直到干净完成,然后删除测试工作区。只有真实工作区成功启动才算完成。

使用方式 按上述三步执行:先检查仓库并澄清疑问,再编写配置并获用户批准,最后创建临时工作区验证。

适用场景 需要为使用 Superset 的仓库配置可复现、自动化的新工作区初始化流程的开发者。

限制与注意事项 setup 必须幂等且快速(目标一分钟内),慢步骤会使每次创建工作区变得痛苦;secrets/env 应在 setup 时从主检出复制,绝不提交;.superset/config.local.json(被 gitignore)允许个人以 before/after 数组扩展脚本而不改动共享配置。