GitHub Actions 矩阵构建器

解决什么问题

在 GitHub Actions 中，矩阵策略（matrix strategy）是让同一工作流在多个环境下并行执行的标准做法——比如多个 Node.js 版本、多个操作系统。但手工编写和维护矩阵配置有三个痛点：

• 版本漂移：仓库里实际使用的运行时版本和依赖版本会随时间变化，硬编码的矩阵很快就会过时。
• 配置重复：每个新分支或新语言栈都要手动补一份 matrix.include，容易遗漏。
• 文件解析成本：要从 package.json、setup.py、.nvmrc 等配置中提取版本信息，自己写脚本既繁琐又脆弱。

这个技能如何工作

这个技能通过 GitHub REST API 和 js-yaml 的 YAML AST 解析能力，自动化生成动态的 CI/CD 矩阵策略。

核心能力包括：

• 自动版本检测：从仓库配置文件中识别语言版本，无需手动维护版本列表。
• 多维度覆盖：自动收集操作系统目标和依赖变体，生成完整的矩阵维度。
• 动态构建：使用 js-yaml 将解析结果转化为合法的 GitHub Actions 矩阵 YAML 结构。

典型工作流：

1. 读取仓库中的配置文件（如 .nvmrc、package.json）。
2. 通过 GitHub REST API 获取仓库元数据和环境信息。
3. 用 js-yaml 解析现有 workflow YAML，定位需要注入矩阵的位置。
4. 生成可直接粘贴到 workflow.yml 的 matrix 配置片段。

适用边界与注意点

• 需要 Node.js 运行时支持，且目标仓库必须启用 GitHub Actions。
• 生成的矩阵策略遵循 GitHub Actions 原生语法，不会引入第三方依赖到 workflow 运行时本身。
• 对于非标准命名或自定义配置文件，检测可能覆盖不全，需要在生成后手动校验。
• 涉及部署到第三方平台（如 Azure App Service）的场景，技能本身只负责矩阵生成，部署逻辑仍需自行编写。