asiaostrich/locales/zh-CN/skills/ci-cd-assistant

CI/CD 管线助手

语言: English | 简体中文

引导 CI/CD 管线设计，遵循业界最佳实践与 DORA 指标。

管线阶段参考

BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
构建       测试      分析         部署       验证

| 阶段 | 用途 | 关键活动 | |------|------|----------| | Build | 编译与打包 | 安装依赖、编译、产出制品 | | Test | 质量验证 | 单元、集成、端到端测试 | | Analyze | 代码质量 | 代码检查、安全扫描、覆盖率 | | Deploy | 发布到环境 | 预备环境 → 生产环境部署 | | Verify | 部署后验证 | 冒烟测试、健康检查、监控 |

DORA 指标快速参考

| 指标 | 精英 | 高 | 中 | 低 | |------|------|-----|-----|-----| | 部署频率 | 按需（每日多次） | 每周至每月 | 每月至半年 | > 6 个月 | | 变更前置时间 | < 1 小时 | 1 天至 1 周 | 1 至 6 个月 | > 6 个月 | | MTTR | < 1 小时 | < 1 天 | 1 天至 1 周 | > 6 个月 | | 变更失败率 | 0–15% | 16–30% | 16–30% | > 30% |

最佳实践检查清单

• [ ] 快速失败 — 先执行最快的检查（lint → 单元 → 集成 → E2E）
• [ ] 缓存依赖 — 在运行之间缓存 node_modules、.m2、pip cache
• [ ] 并行作业 — 将测试套件分散到并行执行器
• [ ] 不可变制品 — 构建一次，将相同制品部署到所有环境
• [ ] 环境一致 — 保持预备环境与生产环境一致
• [ ] 密钥管理 — 绝不硬编码密钥；使用 vault/环境变量
• [ ] 分支保护 — 要求 CI 通过才能合并
• [ ] 回滚策略 — 部署失败时自动回滚

平台专属提示

| 平台 | 缓存 | 并行化 | 密钥 | 备注 | |------|------|--------|------|------| | GitHub Actions | actions/cache | matrix 策略 | secrets.* | 使用 reusable workflows | | GitLab CI | cache: 关键字 | parallel: 关键字 | CI/CD Variables | 使用 include: 模块化 | | Jenkins | Stash/unstash | parallel {} 块 | Credentials plugin | 使用 shared libraries |

CI 作业编排模式

反复出现的 CI 作业编排模式（UDS #126）。每条原则平台无关；对照栏显示各平台的写法。

触发分离

将重型慢速套件（完整 E2E）以触发条件与每次变更的轻量检查分离，使 runner 成本随风险而非每次 push 增长。

| 需求 | GitHub Actions | GitLab CI | Jenkins | |------|----------------|-----------|---------| | 重型套件排程触发 | on: schedule: | rules: if $CI_PIPELINE_SOURCE == "schedule" | cron 触发 | | 轻量检查每次变更 | on: pull_request | rules: if $CI_PIPELINE_SOURCE == "merge_request_event" | SCM webhook |

⚠️ 反模式：每次 push 跑完整 E2E。

共享资源序列化

当多个作业触及同一个有状态共享资源（单一测试环境 / runner / 部署目标）时，序列化以防并发污染。

| 需求 | GitHub Actions | GitLab CI | Jenkins | |------|----------------|-----------|---------| | 互斥 | concurrency: { group: … } | resource_group: | lock(resource: …) |

⚠️ 反模式：两作业并行写同一 DB/环境。

变更检测闸控

当某范围的 HEAD 自上次成功未变（或变更只触及范围外路径）时，跳过 deploy/test 以节省 runner。明确定义「未变」（上次成功 SHA 或路径过滤）。

| 需求 | GitHub Actions | GitLab CI | Jenkins | |------|----------------|-----------|---------| | 范围未变则跳过 | paths: / dorny/paths-filter | rules: changes: / SHA 比对 | changeset 条件 |

⚠️ 反模式：文档-only commit 跑完整部署。

咨询 vs 闸控作业

明确声明每个作业是 advisory（回报但不挡合并）或 gating（挡合并）。混淆会在噪声上卡关、或漏掉该挡的。（安全闸门是 Block/Warn/Log 特例——见 pipeline-security-gates。）

| 需求 | GitHub Actions | GitLab CI | Jenkins | |------|----------------|-----------|---------| | Advisory（不挡） | continue-on-error: true | allow_failure: true | catchError → unstable | | Gating（挡合并） | required status check | 默认（无 allow_failure） | hard fail |

⚠️ 反模式：把噪声 lint 设硬闸，或把关键套件设 advisory。

排错：npm ci EUSAGE

npm ci 需要 committed lockfile。若 package-lock.json 被 gitignore，CI 会以 EUSAGE 失败。修法：commit lockfile，或 CI-only 安装用 npm install --no-audit --no-fund --ignore-scripts（跳过 CI 不需要的 prepare/husky hook）。

使用方式

• /ci-cd - 显示完整管线指引
• /ci-cd github-actions - GitHub Actions 专属提示
• /ci-cd --optimize - 管线优化建议
• /ci-cd build - 构建阶段最佳实践

下一步引导

/ci-cd 完成后，AI 助手应建议：

管线指引已提供。建议下一步：

• 执行 /deploy 设定部署策略
• 执行 /security 检查管线安全
• 执行 /testing 设计测试策略
• 执行 /commit 创建规范化提交

参考

• 核心规范：pipeline-integration-standards.md
• 核心规范：deployment-standards.md