ci-cd-and-automation

CI/CD and Automation - 自动化持续集成与部署

技能概述

CI/CD and Automation 技能帮助您自动设置和管理持续集成与部署管道，确保每次代码变更都经过完整的质量检查流程，包括 lint、类型检查、单元测试、构建和安全审计，实现"左移"测试和快速安全的生产部署。

适用场景

1. 新项目 CI 管道搭建

当您启动一个新项目时，该技能可以快速建立完整的质量门禁流程。从基本的 lint、类型检查、单元测试，到集成测试和 E2E 测试，每个环节都有现成的 GitHub Actions 配置模板。特别适用于 Node.js 项目，支持 PostgreSQL 数据库集成测试和 Playwright E2E 测试的自动化配置。

2. 现有项目 CI/CD 优化

如果您的 CI 管道运行缓慢（超过 10 分钟），该技能提供系统的优化方案：依赖缓存、并行任务、矩阵构建、按需运行等策略。同时包含自动化依赖更新（Dependabot/Renovate）配置和 Build Cop 角色设置，帮助团队保持 CI 管道健康运行。

3. 部署策略和回滚机制

支持多种部署策略配置：预览部署（每次 PR 自动部署测试环境）、特性开关（解耦部署和发布）、分级发布（Staging → Production）以及手动回滚工作流。强调每个部署都应该可逆，并提供完整的 GitHub Actions 配置示例。

核心功能

1. 完整质量门禁流程

自动配置从代码提交到生产发布的完整检查链路：Lint 检查 → TypeScript 类型检查 → 单元测试 → 构建 → 集成测试 → E2E 测试（可选）→ 安全审计 → 包大小检查。每个环节都严格通过才能继续，确保"左移"原则落地——在开发阶段就发现问题，而不是在生产环境中调试。

2. GitHub Actions 自动化配置

提供即用型 YAML 配置模板，涵盖基本 CI 管道、数据库集成测试、E2E 测试、预览部署和手动回滚等工作流。支持 GitHub Secrets 安全管理、服务容器（PostgreSQL）健康检查、构建产物上传等功能。所有配置都遵循最佳实践，避免硬编码密钥，使用缓存优化性能。

3. AI 智能反馈循环

当 CI 失败时，该技能建立了一套清晰的反馈机制：将 CI 失败输出直接反馈给 AI 代理，代理会自动修复 Lint 错误（运行 npm run lint --fix）、定位并修复类型错误、遵循调试技能解决测试失败、检查配置和依赖解决构建错误，然后推送修复并重新触发 CI，形成完整的自动化修复闭环。

常见问题

如何从头搭建一个完整的 CI/CD 管道？

从基本的 GitHub Actions 配置开始，逐步添加质量检查门禁。首先配置 .github/workflows/ci.yml 包含 lint、类型检查、单元测试和构建步骤。然后根据需要添加集成测试（如数据库测试）和 E2E 测试。最后配置分支保护规则，确保 CI 通过才能合并。该技能提供完整的配置模板和最佳实践指南。

CI 管道运行太慢怎么优化？

按照影响力大小依次应用以下策略：使用 actions/setup-node 的缓存选项缓存依赖；将 lint、typecheck、test、build 拆分为并行任务；使用路径过滤器跳过无关任务（如仅文档变更时跳过 E2E 测试）；使用矩阵构建将测试套件分片到多个运行器；将慢速测试从关键路径移除，改为定时运行。目标是让完整测试套件在 10 分钟内完成。

CI 失败后如何高效调试和修复？

建立清晰的反馈循环：将 CI 失败的具体错误信息复制并反馈给 AI 代理，说明"CI 管道因以下错误失败，请修复并在本地验证后再次推送"。AI 会根据错误类型自动采取相应修复策略：Lint 错误运行自动修复，类型错误定位并修复类型定义，测试失败遵循调试技能，构建错误检查配置和依赖。修复后自动提交并重新触发 CI，实现自动化修复闭环。