name: github-actions-gen description: GitHub Actions CI/CD 流水线生成器：根据项目技术栈自动创建 workflows

GitHub Actions CI/CD 生成器

触发条件

当用户要求创建 CI/CD 流水线、GitHub Actions workflow、自动化部署配置时激活。

工作流程

1. 项目分析

• 检测项目语言和框架（package.json / requirements.txt / go.mod / Cargo.toml 等）
• 识别现有 CI 配置（.github/workflows/）
• 分析项目结构：单体仓库 or 单项目、monorepo 工具（nx / turborepo / lerna）
• 检测测试框架（jest / pytest / go test / cargo test）

2. 流水线设计

根据项目类型生成对应 workflow：

通用流水线模板：

• ci.yml — 代码检查 + 测试（push/PR 触发）
• release.yml — 版本发布（tag 触发）
• deploy.yml — 部署流水线（按需）

前端项目额外：

• Node.js 版本矩阵测试
• Lighthouse 性能检测
• 静态资源 CDN 缓存失效

后端项目额外：

• Docker 镜像构建 + 推送
• 数据库 migration 检查
• API 契约测试

3. 生成配置

• 使用 GitHub Actions 最佳实践
• 合理利用 cache（actions/cache）加速构建
• 矩阵策略覆盖多版本
• Secrets 引用安全规范（不硬编码）
• 中文注释说明每个 step 的作用

4. 输出文件

在 .github/workflows/ 目录生成：

• ci.yml — 主 CI 流水线
• release.yml — 发布流水线（如需要）
• README-CICD.md — 流水线使用说明

输出格式

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

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

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20, 22]  # 按项目调整
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'
      - run: npm ci
      - run: npm test
      - run: npm run lint

质量检查清单

• workflow 文件语法正确（可用 actionlint 验证）
• 使用固定版本 tag（避免 @main）
• Secrets 通过 ${{ secrets.XXX }} 引用
• 设置适当的权限（permissions）
• 超时时间合理（timeout-minutes）
• 失败通知机制（Slack / 邮件 / 微信 webhook）

常见陷阱

• Node.js 项目：确保 lockfile（package-lock.json / pnpm-lock.yaml）存在，否则 npm ci 会失败
• Python 项目：注意 requirements.txt 和 pyproject.toml 的优先级
• Docker 构建：使用 multi-stage build 减小镜像体积
• 缓存策略：key 要包含 lockfile hash，否则缓存可能过期
• 矩阵测试：不要过度配置，3-5 个版本足够

示例

用户输入：「帮我给这个 Next.js 项目创建 CI/CD 流水线」

输出：

1. 分析 package.json 检测 Next.js 版本、测试框架、部署目标
2. 生成 ci.yml（lint + test + build）
3. 生成 deploy.yml（Vercel / Docker 部署）
4. 生成使用说明 README-CICD.md