⚡

部署前本地验证流程 deploy

本技能定义了一个严格的部署前本地验证流程，旨在确保代码质量并防止将未经充分测试的代码部署到生产环境。它强制要求在运行任何部署命令（如 Vercel 或 git push）之前，必须按顺序完成本地构建、启动开发服务器、手动功能测试和运行自动化测试。该流程强调 "本地优先" 和 "零假设" 原则，是 DevOps 和 CI/CD 实践中保障软件发布可靠性的关键环节。 关键词：部署流程，本地测试，CI/CD，DevOps，Vercel，代码质量，生产部署，前端测试，自动化测试，预防性检查

DevOps 0 次安装 0 次浏览 更新于 3/3/2026

name: deploy description: 在任何部署前强制执行本地测试。必须在运行 vercel、git push 或任何部署命令之前使用。防止部署未经测试的代码。

部署技能

在完成以下所有步骤之前，切勿部署。

必需的工作流程

在任何部署（vercel、推送到主分支的 git push 等）之前：

1. 本地构建

pnpm build
  • 必须零错误完成
  • 检查输出中的警告

2. 启动本地开发服务器

pnpm dev
  • 服务器必须成功启动

3. 在浏览器中测试

  • 在 Chrome DevTools MCP 中打开本地 URL
  • 手动测试所有已更改的功能：
    • 点击按钮，验证其是否工作
    • 如果适用，测试键盘输入
    • 提交表单，验证响应
    • 检查控制台错误

4. 验证测试通过（如果存在测试）

pnpm test

5. 只有在那之后才部署

在上述所有步骤通过后：

vercel --prod

规则

  1. 没有捷径 - 必须完成每一步
  2. 没有假设 - “之前能运行” 不是验证
  3. 更改后测试 - 任何代码更改都需要重新测试
  4. 本地优先 - 永远不要为了看某个东西是否能在线上工作而部署

需要避免的常见错误

  • 构建后未经浏览器测试立即部署
  • 假设依赖项更改不会破坏任何东西
  • 跳过键盘/交互测试
  • 为了 “检查它在 Vercel 上是否工作” 而部署

当用户说 “部署” 时

  1. 询问：“您已经在本地验证过了吗？让我来核对一下检查清单。”
  2. 运行构建
  3. 启动开发服务器
  4. 通过 Chrome DevTools MCP 在浏览器中测试
  5. 只有在确认一切正常后，才进行部署