SuperAPI AI 工具集

live-dev-init

部署与运维

查看项目

更新于 10-15 21:13

技能介绍

用途:在任何部署或配置任务之前,初始化开发环境并执行预检。bash 片段为 POSIX(Windows 上为 Git Bash);若 Shell 是 cmd.exe 或 PowerShell,需先翻译再执行;超过单条命令/管道的逻辑应放在 resources/*.js 中,而非 shell 控制流。

主要能力(预检应静默运行):

  1. git、gh:用 command -v git、command -v gh、gh auth status 探测;失败时运行 scripts/install-git-gh-macos.command 或 scripts/install-git-gh-windows.ps1,不得自行发明安装步骤。
  2. node:要求 node --version ≥ scripts/toolchain/catalog.json:node_lts_major;不满足则运行 scripts/course-toolchain-macos.command base 或 scripts/course-toolchain-windows.ps1 -Profile base。
  3. vercel、firebase:用 npx vercel whoami、npx firebase login:list 探测;安装用 npm install -D vercel@latest firebase-tools(不用 -g,避免 EACCES)。登录通过后才可配置或部署。
  4. gitleaks:用 command -v gitleaks 探测,按平台安装后重新探测,绝不可跳过扫描门禁。macOS 优先 brew install gitleaks(但 brew 可能不存在,课程安装器用 Xcode CLT + curl),回退为下载 gitleaks_darwin$(uname -m).tar.gz 解压到 ~/.local/bin(必要时 mkdir 并追加到 shell profile),不用 sudo、不用 /usr/local/bin。Windows 用 winget install gitleaks.gitleaks,回退为下载 gitleaks__windows_x64.zip,解压 gitleaks.exe 到 %USERPROFILE%\bin 并 setx PATH;此处不适用 ~/.local/bin 和 shell profile。

项目状态修复:.nvmrc 应设为 catalog.json:node_lts_major(唯一真源,resources/vercel-preview.yml 读取 node-version-file: '.nvmrc',不得在 yml 硬编码 Node 主版本);.gitignore 需包含 .env、.env.local、.env*.local、service-account JSON 通配,须在首次提交前修复;分支需存在 develop(否则提出从 main 创建),工作在 develop 派生的 feature/<name> 上进行。

密钥保险库策略(硬规则,不可覆盖):凭据只存于 Vercel Env Vars、GitHub Secrets 或已 gitignore 的 .env.local;不得硬编码、不得提交真实 .env 值、不得将真实密钥打印到聊天、日志或提交信息中。

适用场景:需要部署或配置前的统一环境准备。限制:安装步骤不可自行发挥;其余收费、价格、支持平台等暂未提供。