Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

ci-cd

/ci-cd

Prowadzi przez projektowanie, konfigurację i optymalizację pipeline CI/CD, na przykład przy skracaniu czasu buildu.

Licencja
MIT
Ostatnia zmiana repozytorium
08.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format20 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. 管線階段參考
  2. DORA 指標快速參考
  3. 最佳實踐檢查清單
  4. 平台專屬提示
  5. CI 作業編排模式
  6. 使用方式
  7. 下一步引導
  8. 參考
  9. 版本歷史
  10. 授權
Sekcje z nagłówków SKILL.md, w oryginale · 137 linii, 651 słów
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

RepozytoriumWynikLicencja
Ta strona · AsiaOstrich/universal-dev-standards95MIT
iuliandita/skills100MIT
oborchers/fractional-cto100MIT
shafthq/shaft_engine100MIT
nimadorostkar/Claude-Skills-collection100MIT
sudeeppatgar/fullstack-skills100MIT
irahardianto/awesome-agv100MIT
srstomp/pokayokay100MIT
PIXARTSeu/Synapse100AGPL-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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.