GitHub Actions 矩阵编排器

要解决的问题

GitHub Actions 原生的 matrix 策略是静态的：它在 workflow 解析阶段就被固定下来，无法依据仓库的实际状态变化。一旦矩阵维度来自动态数据——上游仓库的分支列表、Issue 标签、外部 API 返回的运行时信息——常见做法是自己拼一个巨大的 matrix JSON 塞进 jobs.<id>.strategy，或者干脆放弃矩阵，改用大量 if: 条件判断。前者脆弱且难以维护，后者牺牲了并行性与可读性。本技能针对的就是这条夹缝。

技能如何工作

• 以 workflow_dispatch 作为入口，支持手动触发并通过 inputs 传入参数，让矩阵生成不绑定固定触发器
• 通过 GitHub REST API 拉取仓库元数据（分支、标签、releases 等），把远程状态转换为矩阵维度
• 借助 actions/github-script 在运行时拼接并注入 strategy.matrix，实现条件化任务包含——不满足条件的组合在 job 级被剔除，而不是靠 if: 在运行时空转浪费 runner 时间
• 对跨账号 AWS 部署场景，使用 OIDC token federation（workflow 声明 id-token: write，AWS 侧配置 trust policy）替代长期 AWS 凭证，矩阵内每个 job 各自换取临时凭证

关键步骤：定义 dispatch 输入 → 调 REST API 归一化数据 → 生成矩阵组合 → 用 github-script 注入 strategy → job 按条件执行。

适用边界与注意点

• 需要启用 Actions 的仓库，且 Token 具备调 REST API 的相应权限
• OIDC 部分要求 AWS 侧 IAM role 已配置对应的 trust policy，否则临时凭证换取会失败
• 动态矩阵会延长 workflow 解析阶段耗时，日志中多一次 API 往返
• 矩阵维度数据源变化频繁时，需要考虑缓存与失效策略，避免每次触发都全量拉取
• 官方 Actions 文档是理解这些前置概念的最佳入口：https://docs.github.com/en/actions