SuperAPI AI 工具集

ai-factory.deploy

部署与运维

查看项目

更新于 10-16 09:20

技能介绍

用途

ai-factory.deploy 是一个部署助手技能,用于帮助用户安全地准备和执行部署,通过自动化检查和文档生成来降低部署风险。它强调“绝不自动部署”,所有部署动作都需要用户确认或手动执行。

主要能力

预检检查(无参数时)

不携带参数时,仅运行部署就绪检查,涵盖以下方面:

  • Git 状态检查:确保工作目录干净、验证在正确分支、检查分支是否与远程同步。
  • 构建检查:运行构建命令(如 npm run build、cargo build 等),报告构建错误。
  • 测试检查:运行测试套件,报告覆盖率(如可用)。
  • 环境检查:验证必需的环境变量,对比 .env.example 与实际环境。
  • 依赖检查:查找安全漏洞(如 npm audit),检查过时的关键包。

预检输出以清单形式呈现,包含各项检查的通过或警告状态,最后给出总体判断(如“Ready for deployment”)。

带环境参数的部署准备

  • /ai-factory.deploy staging:运行预检检查、生成自上次 staging 部署以来的变更日志、提供 staging 环境的部署命令、将发布标记为 staging-{date}。
  • /ai-factory.deploy production:运行所有预检检查(更严格),要求 Git 状态干净、要求所有测试通过、生成完整发布说明、创建 Git 发布标签、提供生产环境部署命令。

发布说明生成

在部署时,从以下来源生成发布说明:自上次标签/发布以来的 Git 提交、合并的 PR 标题和描述、约定式提交信息。格式按类别分组,如 Features、Bug Fixes、Other Changes,并附上对应的提交信息和 PR 编号。

CI/CD 集成

检测并提供以下平台的部署命令:

  • Vercel:vercel --prod
  • Netlify:netlify deploy --prod
  • Railway:railway up
  • Docker:构建和推送命令
  • Kubernetes:kubectl apply 命令
  • GitHub Actions:触发工作流

使用方式

通过斜杠命令调用:

  • /ai-factory.deploy:运行所有预检检查,报告就绪状态。
  • /ai-factory.deploy staging:准备 staging 部署并附带变更日志。
  • /ai-factory.deploy production:完整的生产部署工作流并生成发布说明。

适用场景

适用于需要在部署前进行系统化检查、生成发布文档、或需要针对不同环境(staging、production)准备部署命令的开发与运维流程。特别适合希望避免手动遗漏检查项、需要规范化发布说明、或需要明确 CI/CD 部署命令的场景。

安全特性与限制

安全特性包括:

  • 绝不自动部署到生产环境。
  • 始终显示将要部署的差异。
  • 对破坏性操作要求确认。
  • 建议回滚命令。
  • 记录部署操作。

限制:该技能不自行执行部署(尤其是生产环境),仅提供准备、检查和命令建议。具体部署仍需用户手动执行或通过对应 CI/CD 平台完成。