AgentSkillsCN

matrix-distribution

使用 GitHub Actions matrix 策略并结合失败隔离、速率限制和条件逻辑，在动态目标列表上并行化操作。

SKILL.md
--- frontmatter
name: matrix-distribution
description: >-
  Parallelize operations across dynamic target lists using GitHub Actions matrix strategies with failure isolation, rate limiting, and conditional logic.

Matrix Distribution

When to Use This Skill

Poor Fit

  • •Sequential operations where order matters
  • •Operations with shared state between targets
  • •When total job count would exceed GitHub Actions limits (256)

Implementation

Dynamic Matrix

Generate the target list in a discovery stage:

See examples.md for detailed code examples.

Failure Isolation

Prevent one failure from canceling other jobs:

yaml
strategy:
  matrix:
    target: ${{ fromJson(needs.discover.outputs.targets) }}
  fail-fast: false  # Critical: continue processing other targets

Rate Limiting

Control concurrency to avoid API rate limits:

yaml
strategy:
  matrix:
    target: ${{ fromJson(needs.discover.outputs.targets) }}
  max-parallel: 10  # Limit concurrent jobs

Examples

See examples.md for code examples.

References