ci-github-actions

name	ci-github-actions
description	Use this skill when setting up or modifying CI pipelines, GitHub Actions workflows, or automated checks (lint, typecheck, test, build) for this project. Trigger words: CI, GitHub Actions, ワークフロー, パイプライン, 自動テスト, lint チェック, typecheck, ビルド検証, .github/workflows.

CI(GitHub Actions)

いつ使うか

• CI パイプラインを新規作成・変更するとき。
• PR で自動的に lint / typecheck / test / build を走らせたいとき。

やること

• pnpm + Node 22 をセットアップし、依存はキャッシュする。
• ジョブは「lint → typecheck → unit test → build」を最低限通す。
• E2E は別ジョブ/必要時のみ(時間とコスト管理)。
• 秘密は GitHub Secrets。ワークフロー YAML に値を書かない。
• 失敗を握りつぶさない(continue-on-error を安易に使わない)。

守るルール

• ✅ Node 22 / pnpm / 依存キャッシュ。
• ✅ lint・typecheck・test・build を必須チェックに。
• ✅ 秘密は Secrets 経由のみ。
• ❌ YAML にトークン/接続文字列をハードコードしない。
• ❌ テスト失敗を || true で無視しない。

典型例(コード片)

# .github/workflows/ci.yml
name: CI
on: { pull_request: {}, push: { branches: [main] } }
jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: pnpm }
      - run: pnpm install --frozen-lockfile
      - run: pnpm lint
      - run: pnpm typecheck
      - run: pnpm test --run
      - run: pnpm build

アンチパターン

• ローカルでしか通らない手順を CI に書かず「自分の環境では動く」状態。
• 秘密を YAML にベタ書きしてリポジトリに残す。
• 失敗ジョブを無視するフラグで「常に緑」を演出する。