ci-cd-and-automation

技能简介

该技能用于自动化 CI/CD 流水线搭建。它帮助你在每次代码变更时自动执行质量检查（如 lint、类型检查、测试、构建等），确保任何未经校验的变更都无法进入生产环境。同时提供部署策略和失败反馈模式，让 Agent 与 CI 形成高效闭环。

使用场景

• 为新项目搭建 CI 流水线
• 添加或修改自动化检查项
• 配置部署流水线（预览部署、特性开关等）
• 当提交需触发自动验证时使用
• 调试 CI 失败问题

使用方法

无需额外安装命令。该技能提供可复用的 CI/CD 配置模板，直接在仓库中创建 .github/workflows/ci.yml 等文件即可。核心质量门禁必须依次通过：Lint → Type Check → Unit Tests → Build → Integration → E2E → Security Audit → Bundle Size。

基础 CI 示例：

# .github/workflows/ci.yml
name: CI

on:
  pull_request:
    branches: [main]
  push:
    branches: [main]

jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Lint
        run: npm run lint

      - name: Type check
        run: npx tsc --noEmit

      - name: Test
        run: npm test -- --coverage

      - name: Build
        run: npm run build

      - name: Security audit
        run: npm audit --audit-level=high

数据库集成测试需通过 services 启动 PostgreSQL，并将 DATABASE_URL 等敏感信息放入 GitHub Secrets；E2E 测试时可使用 Playwright 安装浏览器并上传失败报告。部署策略支持预览部署和特性开关（Feature Flags），可实现灰度发布与快速回滚。

CI 失败时，应将完整错误输出复制给 Agent，要求其修复后本地验证再推送。常见反馈模式：Lint 失败 → Agent 运行 npm run lint --fix；类型错误 → 查看错误位置并修复；测试失败 → 参考调试技能处理。

注意事项

• 任何质量门禁不可跳过：lint 失败就修代码，不能禁用规则；测试失败就修代码，不能跳过测试。
• 尽早发现错误（Shift Left）：静态分析早于测试，测试早于预发布，预发布早于生产。
• 敏感信息必须使用 GitHub Secrets，即使是 CI 专用测试库的密码也不能硬编码，避免凭据意外泄漏。