SuperAPI AI 工具集

github-actions-ci-workflow

办公与效率

查看项目

更新于 10-15 22:14

技能介绍

用途:为世界构建类等现代 Web 应用配置完整的 GitHub Actions 持续集成与部署流水线。

主要能力:分析项目结构与依赖;在 .github/workflows/ 下生成 ci.yml、deploy.yml、preview.yml 等工作流文件;运行 ESLint、Prettier、类型检查与测试并生成覆盖率;构建应用并上传构建产物;为 node_modules、Next.js 构建缓存及测试产物配置缓存;通过 GitHub API 在 PR 上评论预览 URL 并在 PR 关闭时清理;支持并行任务、条件部署、状态检查、部署门禁、Lighthouse CI 或打包分析,以及 Dependabot 集成。

使用方式:先用脚本 scripts/generate_ci_workflow.py 按检测到的框架(Next.js、Vite、CRA 等)、包管理器(npm、yarn、pnpm)与测试运行器(Jest、Vitest、Playwright)生成工作流文件,再按需定制任务与矩阵构建。缓存使用 actions/cache@v3,并以锁文件作为缓存键。可参考 references/github-actions-best-practices.md、references/deployment-providers.md 及 assets/workflow-templates/ 中的模板。

部署平台:Vercel 使用 vercel-action,Netlify 使用 netlify-cli 配合站点 ID 与令牌,AWS 可配置 S3/CloudFront 或 ECS,Docker 构建并推送镜像,自托管可用 SSH 配合 rsync 或 git pull。Next.js 可缓存 .next/cache 并设置 NEXT_TELEMETRY_DISABLED=1。

限制与注意:缓存未命中需检查缓存键是否包含全部依赖文件;超时需增大超时或拆分并行任务;权限错误需检查仓库密钥与权限;构建失败需确认环境变量;PR 未评论预览 URL 需检查评论权限与令牌范围。需在 README 或工作流注释中记录所需密钥,并配置环境变量与部署凭据。