keito4 · Jan 2, 2026 · Jan 2, 2026 · Jan 2, 2026 · github-actions · Jan 2, 2026
@@ -216,6 +216,135 @@ jobs:
         run: npm run build
 ```
 
+### CI最適化: Path Filters による実行最適化
+
+**目的**: 変更されたファイルに応じて必要なジョブのみを実行することで、CIの実行時間を短縮し、コストを削減します。
+
+#### 実装方法
+
+GitHub Actionsの`on.push.paths`と`on.pull_request.paths`フィルター、および`dorny/paths-filter`アクションを組み合わせて使用します。
+
+##### 1. ワークフローレベルでのフィルタリング
+
+ワークフロー全体をスキップするには、`on`セクションで`paths`を指定します:
+
+```yaml
+on:
+  pull_request:
+    paths:
+      - '**.js'
+      - '**.ts'
+      - '**.mjs'
+      - '**.cjs'
+      - '**.json'
+      - '**.sh'
+      - '**.bats'
+      - '.github/workflows/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.eslintrc.*'
+      - '.prettierrc.*'
+      - 'tsconfig.json'
+  push:
+    branches: [main, master]
+    paths:
+      - '**.js'
+      - '**.ts'
+      # ... 同様のパターン
+```
+
+##### 2. ジョブレベルでの細かい制御
+
+各ジョブを変更内容に応じて実行するには、`dorny/paths-filter`を使用します:
+
+```yaml
+jobs:
+  changes:
+    name: Detect Changes
+    runs-on: ubuntu-latest
+    outputs:
+      code: ${{ steps.filter.outputs.code }}
+      scripts: ${{ steps.filter.outputs.scripts }}
+      workflows: ${{ steps.filter.outputs.workflows }}
+      dependencies: ${{ steps.filter.outputs.dependencies }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - '**.js'
+              - '**.ts'
+              - 'src/**'
+              - 'test/**/*.test.{js,ts}'
+            scripts:
+              - '**.sh'
+              - 'script/**'
+            workflows:
+              - '.github/workflows/**'
+            dependencies:
+              - 'package.json'
+              - 'package-lock.json'
+
+  lint:
+    needs: changes
+    if: needs.changes.outputs.code == 'true' || needs.changes.outputs.dependencies == 'true'
+    # ... lintジョブの内容
+
+  test:
+    needs: changes
+    if: needs.changes.outputs.code == 'true' || needs.changes.outputs.dependencies == 'true'
+    # ... testジョブの内容
+
+  actionlint:
+    needs: changes
+    if: needs.changes.outputs.workflows == 'true'
+    # ... actionlintジョブの内容
+```
+
+##### 3. Quality Gate での skipped 状態の処理
+
+ジョブがスキップされた場合も成功として扱うように、Quality Gateを更新します:
+
+```yaml
+quality-gate:
+  needs: [changes, lint, test, integration-test, actionlint]
+  if: always()
+  steps:
+    - name: Verify all checks passed
+      run: |
+        function check_result() {
+          local result=$1
+          [[ "$result" == "success" || "$result" == "skipped" ]]
+        }
+
+        if ! check_result "${{ needs.lint.result }}"; then
+          echo "::error::Lint & Format failed"
+          exit 1
+        fi
+        # ... 他のジョブも同様にチェック
+```
+
+#### Path Filters のベストプラクティス
+
+| 対象ワークフロー       | 推奨フィルター                                        | 理由                                     |
+| ---------------------- | ----------------------------------------------------- | ---------------------------------------- |
+| **CI Pipeline**        | コード、設定ファイル、ワークフロー自体                | ドキュメントのみの変更でテストをスキップ |
+| **Docker Image Build** | `.devcontainer/**`, `npm/global.json`, `package.json` | DevContainer関連の変更時のみビルド       |
+| **Security Scans**     | コード、依存関係ファイル                              | セキュリティに影響する変更のみスキャン   |
+| **Documentation**      | `**.md`, `docs/**`                                    | ドキュメント変更時のみデプロイ           |
+
+#### 効果測定
+
+Path Filtersを導入すると、以下のような効果が期待できます:
+
+- ドキュメントのみの変更: CI実行時間 **90%削減** (10分 → 1分)
+- DevContainer変更なし: Docker Image Build **スキップ** (45分 → 0分)
+- ワークフローのみの変更: Lint/Test **スキップ**、Actionlintのみ実行
+
+**注意**: mainブランチへのpushでは、すべてのチェックを実行することを推奨します（path filtersを適用しない、または緩めに設定）。
+
 ### フル構成版 (Next.js + Supabase プロジェクト向け)
 
 Elu-co-jp リポジトリから参照:

 fail_on_error: true 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 fail_on_error: true 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
@@ -2,18 +2,82 @@ name: CI
 
 on:
   pull_request:
+    paths:
+      - '**.js'
+      - '**.ts'
+      - '**.mjs'
+      - '**.cjs'
+      - '**.json'
+      - '**.sh'
+      - '**.bats'
+      - '.github/workflows/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.eslintrc.*'
+      - '.prettierrc.*'
+      - 'tsconfig.json'
   push:
     branches: [main, master]
+    paths:
+      - '**.js'
+      - '**.ts'
+      - '**.mjs'
+      - '**.cjs'
+      - '**.json'
+      - '**.sh'
+      - '**.bats'
+      - '.github/workflows/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.eslintrc.*'
+      - '.prettierrc.*'
+      - 'tsconfig.json'
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
+  changes:
+    name: Detect Changes
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      code: ${{ steps.filter.outputs.code }}
+      scripts: ${{ steps.filter.outputs.scripts }}
+      workflows: ${{ steps.filter.outputs.workflows }}
+      dependencies: ${{ steps.filter.outputs.dependencies }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - '**.js'
+              - '**.ts'
+              - '**.mjs'
+              - '**.cjs'
+              - 'src/**'
+              - 'test/**/*.test.{js,ts}'
+              - 'tsconfig.json'
+            scripts:
+              - '**.sh'
+              - 'script/**'
+              - 'test/integration/**'
+            workflows:
+              - '.github/workflows/**'
+            dependencies:
+              - 'package.json'
+              - 'package-lock.json'
+
   lint:
     name: Lint & Format
     runs-on: ubuntu-latest
     timeout-minutes: 10
+    needs: changes
+    if: needs.changes.outputs.code == 'true' || needs.changes.outputs.scripts == 'true' || needs.changes.outputs.dependencies == 'true'
     steps:
       - uses: actions/checkout@v4
 
@@ -41,6 +105,8 @@ jobs:
     name: Unit Tests
     runs-on: ubuntu-latest
     timeout-minutes: 15
+    needs: changes
+    if: needs.changes.outputs.code == 'true' || needs.changes.outputs.dependencies == 'true'
     steps:
       - uses: actions/checkout@v4
 
@@ -87,6 +153,8 @@ jobs:
     name: Integration Tests
     runs-on: ubuntu-latest
     timeout-minutes: 15
+    needs: changes
+    if: needs.changes.outputs.scripts == 'true' || needs.changes.outputs.dependencies == 'true'
     steps:
       - uses: actions/checkout@v4
 
@@ -118,6 +186,8 @@ jobs:
     name: Workflow Lint
     runs-on: ubuntu-latest
     timeout-minutes: 5
+    needs: changes
+    if: needs.changes.outputs.workflows == 'true'
     steps:
       - uses: actions/checkout@v4
 
@@ -131,7 +201,7 @@ jobs:
     name: Quality Gate
     runs-on: ubuntu-latest
     timeout-minutes: 5
-    needs: [lint, test, integration-test, actionlint]
+    needs: [changes, lint, test, integration-test, actionlint]
     if: always()
     steps:
       - name: Check job results
@@ -154,9 +224,35 @@ jobs:
         env:
           LINT_RESULT: ${{ needs.lint.result }}
           TEST_RESULT: ${{ needs.test.result }}
+          INTEGRATION_RESULT: ${{ needs.integration-test.result }}
+          ACTIONLINT_RESULT: ${{ needs.actionlint.result }}
         run: |
-          if [ "$LINT_RESULT" != "success" ] || [ "$TEST_RESULT" != "success" ]; then
-            echo "::error::Quality gate failed - lint or test jobs did not succeed"
+          # skipped は成功扱い（該当ファイルの変更がない場合）
+          function check_result() {
+            local result=$1
+            [[ "$result" == "success" || "$result" == "skipped" ]]
+          }
+
+          FAILED=false
+          if ! check_result "$LINT_RESULT"; then
+            echo "::error::Lint & Format failed"
+            FAILED=true
+          fi
+          if ! check_result "$TEST_RESULT"; then
+            echo "::error::Unit Tests failed"
+            FAILED=true
+          fi
+          if ! check_result "$INTEGRATION_RESULT"; then
+            echo "::error::Integration Tests failed"
+            FAILED=true
+          fi
+          if ! check_result "$ACTIONLINT_RESULT"; then
+            echo "::error::Workflow Lint failed"
+            FAILED=true
+          fi
+
+          if [ "$FAILED" = true ]; then
+            echo "::error::Quality gate failed - one or more jobs did not succeed"
             exit 1
           fi
 

 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
 run: | 
@@ -3,6 +3,12 @@ name: Build and Release DevContainer Image
 on:
   push:
     branches: [main]
+    paths:
+      - '.devcontainer/**'
+      - 'npm/global.json'
+      - 'package.json'
+      - 'package-lock.json'
+      - '.github/workflows/docker-image.yml'
   workflow_dispatch:
     inputs:
       release_mode:

@@ -3,8 +3,28 @@ name: Security Scans
 on:
   push:
     branches: [main]
+    paths:
+      - '**.js'
+      - '**.ts'
+      - '**.mjs'
+      - '**.cjs'
+      - '**.sh'
+      - 'package.json'
+      - 'package-lock.json'
+      - 'npm/global.json'
+      - '.github/workflows/security.yml'
   pull_request:
     branches: [main]
+    paths:
+      - '**.js'
+      - '**.ts'
+      - '**.mjs'
+      - '**.cjs'
+      - '**.sh'
+      - 'package.json'
+      - 'package-lock.json'
+      - 'npm/global.json'
+      - '.github/workflows/security.yml'
   schedule:
     - cron: '0 5 * * *'