SuperAPI AI 工具集

live-dev-deploy

部署与运维

查看项目

更新于 10-16 01:58

技能介绍

live-dev-deploy 是一个覆盖本地验证、测试驱动自动修复、预览 URL 交付与 Git Flow 发布部署的技能。它把开发到上线的流程拆分为若干带门禁的阶段,强调在提交或推送前必须全部通过。

用途 该技能用于指导从功能开发到生产发布的完整部署生命周期,包括本地验证、自动修复、预览交付和 Git Flow 发布。

主要能力

  1. Git Flow 与发布生命周期:定义 develop → feature/、feature/ → develop、develop → main、main → develop 的转换触发条件与门禁。发布 PR 同时携带标签 v<major>.<minor>.<patch> 与匹配的 package.json:version。禁止在 CI 红色或待定时合并;合并冲突需展示给用户,不自行解决手写源码冲突。生产部署默认不应启用 Vercel Deployment Protection,需保证公开访问;若不可公开访问,会询问是否启用公开访问并引导至 Vercel 项目仪表盘(Settings -> Deployment Protection)关闭。生产故障时可在 main 上 git revert 合并提交并推送。
  2. 本地验证与自动修复:设置、端口发现与测试模板见 references/playwright-qa-rules.md。提交或推送前需通过 Playwright 套件、lint、build 以及 gitleaks protect --staged(针对暂存差异)全部门禁。失败时解析错误与追踪,仅修复实现代码,并在修复循环中重跑(最多 3 次,之后停止并报告)。密钥扫描命中会阻止提交,需移入 vault 并通过 process.env 引用。若功能涉及 Firestore,需针对本地模拟器套件运行 QA 循环,而非真实项目。建议安装可自动安装的钩子管理器(Husky/Lefthook),在 pre-commit 运行 lint 与密钥扫描。
  3. 预览优先交付:不向用户提供 localhost 链接进行验证,而是运行 node resources/resolve-preview-url.js(退出码 0 时打印 PREVIEW_URL=<url>)。轮询通过 resolve-preview-url.js 查询 GitHub Deployments API。若耗时过长,60 秒时延长尝试并告知用户构建进行中;约 5 分钟时使用非交互式 JSON vercel list 过滤到已推送提交;之后报告仪表盘 URL 或 vercel inspect。
  4. 护栏:当请求不良模式(如通过 Context 进行 prop drilling、绕过 GitHub 自动化、将预览数据库复用于生产等)时,暂停并输出请求内容、建议替代方案、安全风险与维护成本,仅在用户逐字输入 "I understand the risk and insist on this." 后继续。
  5. 输出格式:包含验证日志(Vercel 部署链接、Git 分支、PLAYWRIGHT 测试状态)、检查清单(F1 本地 QA 测试、F2 预览 URL、F3 密钥扫描,含结果与证据)、代码变更、冒烟测试输出、剩余风险与复发防护(规则/钩子/测试/技能/不需要及原因,外加仓库 URL、Vercel 项目与 Firebase 项目 id)。

使用方式 bash 代码块为 POSIX(Windows 上为 Git Bash)。任何超出一条命令或管道的逻辑都放在 resources/*.js 中,不放在 shell 控制流里。若 Bash 工具是 cmd.exe 或 PowerShell,需先翻译每个片段再运行。

适用场景 适用于需要规范 Git Flow 发布、本地 Playwright 验证、密钥扫描、预览 URL 交付与生产部署的团队或项目,尤其涉及 Vercel 部署与 Firestore 的场景。

限制 资料未提供具体的安装命令、收费信息、支持平台范围或性能指标。部分流程依赖外部工具(Playwright、gitleaks、Husky/Lefthook、Vercel、GitHub Deployments API),其可用性可能影响技能执行。