matrix-builds

GitHub Actionsマトリックスビルド戦略設計・最適化スキル。複数OS、バージョン、環境での並列テストを実現。Anchors:• GitHub Actions Documentation / 適用: strategy.matrix / 目的: 並列CI/CD• GitHub Actions Workflow Syntax / 適用: include/exclude / 目的: 条件付きビルドTrigger:Use when configuring matrix builds, multi-environment testing, CI parallelization,dynamic matrix generation, or optimizing max-parallel settings.

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill specializes in designing and optimizing GitHub Actions matrix build strategies. It enables developers to implement efficient parallel testing across multiple operating systems, language versions, and environments, significantly reducing CI/CD cycle times while ensuring comprehensive cross-platform compatibility through advanced features like dynamic matrix generation and conditional inclusions.

Use Cases

  • Cross-platform validation: Automatically configuring workflows to run test suites on Ubuntu, Windows, and macOS simultaneously to ensure software portability.
  • Multi-runtime testing: Designing matrices to validate applications against various versions of programming languages (e.g., Node.js 18, 20, 22) to maintain backward compatibility.
  • Dynamic CI/CD pipelines: Implementing fromJSON() logic to generate build matrices on-the-fly based on repository changes or configuration files.
  • Build efficiency optimization: Fine-tuning 'max-parallel' and 'fail-fast' settings to balance resource consumption and provide faster feedback to developers.
  • Complex environment management: Using 'include' and 'exclude' rules to handle specific edge cases or skip incompatible combinations of OS and runtime versions.
namematrix-builds
description|
• GitHub Actions Documentation / 適用strategy.matrix / 目的: 並列CI/CD
• GitHub Actions Workflow Syntax / 適用include/exclude / 目的: 条件付きビルド

Matrix Builds

相対パス: SKILL.md 読込条件: スキル使用時(自動)


概要

GitHub Actions のマトリックスビルド戦略設計スキル。

対象機能:

機能 説明
strategy.matrix OS/バージョン/環境の組み合わせ
include/exclude 条件付きマトリックス拡張・除外
fail-fast ビルド失敗時の制御
max-parallel 最大並列実行数
fromJSON() 動的マトリックス生成

ワークフロー

Phase 1: 要件分析

Task: agents/analyze-requirements.md

入力 出力
テスト要件 マトリックス設計

参照: references/basics.md

Phase 2: マトリックス設計

Task: agents/design-matrix.md

入力 出力
マトリックス設計 ワークフロー YAML

参照: references/patterns.md, references/dynamic-matrix.md

Phase 3: 検証

Task: agents/validate-matrix.md

入力 出力
ワークフロー YAML 検証レポート

ベストプラクティス

すべきこと 避けるべきこと
必要な変動軸を明確に定義 過度な組み合わせ爆発
fail-fast: false で全結果確認 デフォルト fail-fast の無意識使用
max-parallel で並列数を最適化 無制限並列によるリソース枯渇
fromJSON() で動的マトリックス生成 ハードコードされたマトリックス
include/exclude で条件付き拡張 複雑すぎる条件の組み合わせ

Task ナビゲーション

Task 目的 参照リソース
analyze-requirements.md テスト環境・バージョン要件分析 basics.md
design-matrix.md マトリックス構造設計 patterns.md
validate-matrix.md YAML 構文・動作検証 scripts

リソース参照

References

ファイル 内容 読込条件
basics.md マトリックス基礎構文 初回使用時
patterns.md include/exclude、fail-fast パターン 設計時
dynamic-matrix.md fromJSON() 動的生成 動的生成時
matrix-strategy.md 詳細戦略ガイド 最適化時

Assets

ファイル 内容
matrix-template.yaml マトリックスビルドテンプレート

Scripts

スクリプト 用途
generate-matrix.mjs マトリックス自動生成
log_usage.mjs 使用記録

クイックリファレンス

基本構文

strategy:
  matrix:
    os: [ubuntu-latest, windows-latest, macos-latest]
    node: [18, 20, 22]

include/exclude

strategy:
  matrix:
    os: [ubuntu-latest, windows-latest]
    node: [18, 20]
    exclude:
      - os: windows-latest
        node: 18
    include:
      - os: ubuntu-latest
        node: 22
        experimental: true

fail-fast 制御

strategy:
  fail-fast: false # 全ジョブ完了まで継続
  max-parallel: 4 # 最大並列数

関連スキル

  • github-actions-syntax - ワークフロー構文
  • caching-strategies-gha - キャッシュ戦略
  • reusable-workflows - 再利用可能ワークフロー