setting-up-ci

CI のセットアップ（GitHub Actions）

ユーザーから CI、継続的インテグレーション、ビルドパイプライン、または GitHub Actions のセットアップを求められた場合に、このスキルを使用します。

手順

1. プロジェクト構成を確認する — package.json（Node.js）、requirements.txt / pyproject.toml（Python）、go.mod（Go）、または Turborepo などのモノレポツールを確認します。

2. .github/workflows/ci.yml を作成する

   Node.js プロジェクトの場合：

   name: CI
   
   on:
     push:
       branches: [main]
     pull_request:
       branches: [main]
   
   jobs:
     build:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - uses: actions/setup-node@v4
           with:
             node-version: 20
             cache: npm
         - run: npm ci
         - run: npm run lint
         - run: npm run typecheck
         - run: npm test
         - run: npm run build
   

3. 型チェックを追加する — package.json に typecheck スクリプトがない場合は、"typecheck": "tsc --noEmit" を追加します。

4. キャッシュを追加する — actions/setup-node の cache オプションで node_modules を処理します。Turborepo を使用するモノレポでは、リモートキャッシュまたは .turbo 用の actions/cache を追加します。

5. マトリックステストを追加する（任意） — Node のバージョンや OS をまたいでテストする必要がある場合：

   strategy:
     matrix:
       node-version: [18, 20, 22]
   

6. デプロイ手順を追加する（任意） — 要望された場合は、main へのプッシュ時のみ実行され、ビルドジョブの成功を条件とするデプロイジョブを追加します：

   deploy:
     needs: build
     if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - run: npm ci && npm run build
       - run: npx vercel deploy --prod --token=${{ secrets.VERCEL_TOKEN }}
   

7. ステータスバッジを追加する — ワークフローのステータスバッジをプロジェクトの README に追加します：

   ![CI](https://github.com/OWNER/REPO/actions/workflows/ci.yml/badge.svg)
   

注意事項

• CI を高速に保ちます。パイプラインが遅い場合は、別々のジョブを使って lint と型チェックを並行して実行します。
• 再現性のあるインストールには、npm install ではなく npm ci を使用します。
• シークレット（API キー、デプロイトークン）は GitHub リポジトリの設定に保存し、ワークフローファイルには決して記載しないでください。