ci-cd
/ci-cd
Prowadzi przez projektowanie, konfigurację i optymalizację pipeline CI/CD, na przykład przy skracaniu czasu buildu.
- Autor
- AsiaOstrich ↗
- Repozytorium
- universal-dev-standards ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 08.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 4
Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi przez projektowanie, konfigurację i optymalizację pipeline CI/CD, na przykład przy skracaniu czasu buildu.
Argumenty
/ci-cd [pipeline config or stage | Pipeline 配置或階段]
Oryginalny opis (EN)
引導 CI/CD 管線的設計、設定與最佳化。 Use when: 建置管線、縮短建置時間、設定部署階段。 Not for: 沒有 CI/CD 平台的部署——請用 /deploy;版本號遞增與晉級——請用 /release。 Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署, 管線.
Jak działa
- 管線階段參考
- DORA 指標快速參考
- 最佳實踐檢查清單
- 平台專屬提示
- CI 作業編排模式
- 使用方式
- 下一步引導
- 參考
- 版本歷史
- 授權
Podgląd SKILL.md
---
name: ci-cd
source: ../../../../skills/ci-cd-assistant/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-10-11
source_hash: db7970b6ed79
status: current
scope: universal
description: |
引導 CI/CD 管線的設計、設定與最佳化。
Use when: 建置管線、縮短建置時間、設定部署階段。
Not for: 沒有 CI/CD 平台的部署——請用 /deploy;版本號遞增與晉級——請用 /release。
Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署, 管線.
allowed-tools: Read, Grep, Glob
argument-hint: "[pipeline config or stage | Pipeline 配置或階段]"
---
# CI/CD 管線助手
> **語言**: [English](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/skills/ci-cd-assistant/SKILL.md) | 繁體中文
引導 CI/CD 管線設計,遵循業界最佳實踐與 DORA 指標。
## 管線階段參考
```
BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
建置 測試 分析 部署 驗證
```
| 階段 | 用途 | Key Activities | 關鍵活動 |
|------|------|----------------|----------|
| **Build** | 編譯與打包 | Dependency install, compilation, artifact creation | 安裝相依、編譯、產出成品 |
| **Test** | 品質驗證 | Unit, integration, E2E tests | 單元、整合、端對端測試 |
| **Analyze** | 程式碼品質 | Lint, security scan, coverage report | 程式碼檢查、安全掃描、覆蓋率 |
| **Deploy** | 發布到環境 | Staging → Production rollout | 預備環境 → 正式環境部署 |
| **Verify** | 部署後驗證 | Smoke tests, health checks, monitoring | 冒煙測試、健康檢查、監控 |
## 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`](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/core/pipeline-security-gates.md)。)
| 需求 | 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)。
## 使用方式
```bash
/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](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/core/pipeline-integration-standards.md)
- 核心規範:[deployment-standards.md](https://github.com/AsiaOstrich/universal-dev-standards/blob/main/core/deployment-standards.md)
## 版本歷史
| 版本 | 日期 | 變更 | 變更說明 |
|------|------|------|----------|
| 1.1.0 | 2026-06-24 | 新增 CI 作業編排模式(觸發分離、共享資源序列化、變更偵測閘控、advisory vs gating、`npm ci` `EUSAGE` 排錯)— UDS #126 → XSPEC-300 | 新增 CI 作業編排模式(UDS #126) |
| 1.0.0 | 2026-03-24 | 初始版本 | 初始版本 |
## 授權
CC BY 4.0 — 文件內容
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · AsiaOstrich/universal-dev-standards | 95 | MIT |
| iuliandita/skills | 100 | MIT |
| oborchers/fractional-cto | 100 | MIT |
| shafthq/shaft_engine | 100 | MIT |
| nimadorostkar/Claude-Skills-collection | 100 | MIT |
| sudeeppatgar/fullstack-skills | 100 | MIT |
| irahardianto/awesome-agv | 100 | MIT |
| srstomp/pokayokay | 100 | MIT |
| PIXARTSeu/Synapse | 100 | AGPL-3.0 |
Migawka bazy z 13.11.2026 · wersja paczki 5fd27507d479 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100ci-cd-assistant
Prowadzi przez projektowanie, konfigurację i optymalizację pipeline'ów CI/CD w GitHub Actions: budowa potoku, skracanie czasu buildów i etapy wdrożenia. - 84ci-cd-assistant
Prowadzi projektowanie, konfigurację i optymalizację pipeline CI/CD, w tym skracanie czasu budowania i etapy wdrożenia. - 90ci-cd-pipeline-builder
Projektuje i generuje pipeline'y CI/CD na podstawie stosu projektu dla GitHub Actions, GitLab CI, CircleCI i Buildkite, także przy migracji, bramkach wdrożeniowych i skracaniu buildów. - 95memstack-deployment-ci-cd-pipeline
Konfiguruje automatyczne pipeline'y budowania, testów i wdrożeń w GitHub Actions.