SuperAPI AI 工具集

ci-cd

部署与运维

查看项目

更新于 10-16 06:39

技能介绍

CI/CD 是一个用于生成和管理项目持续集成与持续部署流水线的技能,主要围绕 GitHub Actions 展开,覆盖 lint、测试、构建和部署的自动化,适用于 npm、pip、pnpm 等包管理器的项目。

用途 该技能用于在项目中搭建 CI/CD 流水线,或对已有配置进行审计与修复。当用户需要设置 CI、创建 GitHub Actions 工作流、检查现有 CI/CD 配置或修复失败的 CI 时,可以使用该技能。

主要能力 技能提供三个主要命令:

  • /ci-cd github-actions:生成 GitHub Actions 工作流。
  • /ci-cd check:审计现有的 CI/CD 配置。
  • /ci-cd fix:修复失败的 CI/CD 问题。

在生成工作流前,技能会自动检测项目技术栈,包括包管理器(npm、pnpm、yarn、bun、pip、uv、poetry)、框架(Next.js、React、FastAPI、Django 等)、测试运行器(jest、vitest、pytest)、代码检查工具(eslint、biome、ruff)以及是否已有 CI 配置。

针对 Node.js/TypeScript 项目,技能可生成包含 lint-and-typecheck、test、build 三个作业的 ci.yml,并支持 pnpm、yarn、bun、monorepo(turbo)、Next.js 等适配规则。针对 Python 项目,可生成包含 lint、typecheck、test、build 的 ci.yml,并支持 uv、poetry、Django、FastAPI 等适配规则。

技能还支持可选的持续部署配置,包括 Vercel(Next.js)、Docker(任意项目)和 PyPI(Python 包)的部署作业。此外,技能可推荐并生成 Dependabot 配置,并可根据需要添加 CodeQL、Release Please、预览部署、矩阵测试等扩展。

使用方式 通过命令调用:/ci-cd github-actions 生成工作流,/ci-cd check 审计现有配置,/ci-cd fix 修复失败问题。生成的工作流文件通常位于 .github/workflows/ 目录下。

审计功能会检查现有工作流是否设置了 concurrency、是否使用锁文件安装、是否配置依赖缓存、是否包含 lint/typecheck/test、构建是否在测试通过后运行、密钥是否硬编码、是否取消进行中的 PR 工作流、Node/Python 版本是否固定、actions 是否固定到主版本等。

修复功能会读取失败的运行日志(gh run view --log-failed),识别错误类别(依赖、lint、类型、测试、构建),进行修复并推送,通过 gh run watch 验证。修复最多尝试 3 次,每次尝试对应一次 git push 和 gh run watch 周期;若 3 次均失败,则停止并向用户报告已尝试的方法、失败原因、错误日志和建议的后续步骤。

适用场景 适用于需要为 npm、pip、pnpm 等项目搭建 GitHub Actions CI/CD 流水线的开发者,以及需要审计或修复现有 CI/CD 配置的团队。

限制 该技能主要面向 GitHub Actions,资料中未提供对其他 CI 平台(如 GitLab CI、Jenkins、CircleCI)的生成支持,仅在项目检测阶段会检查这些平台的配置文件是否存在。修复功能有 3 次尝试上限,超过后需人工介入。资料中未提供该技能的收费、价格或平台兼容性等额外信息。