该技能针对 .github/workflows/ 目录下的所有 GitHub Actions 工作流,覆盖部署、测试、发布等场景,提供编写与编辑工作流时的规范指导。
主要规则:一是优先使用成熟且有人维护的 Action,而非手写脚本;仅在没有 Action 覆盖时手写,并在 PR 中说明。检代码、docker 登录/构建/推送、云认证、上传产物、发版等均由官方或厂商 Action 覆盖(如 actions/、docker/、google-github-actions/、pulumi/)。第三方 Action 需检查维护活跃度、使用广度,最好来自工具厂商;只有单一维护者且持有凭据的冷门 Action 不如脚本。
二是编写时核验版本,不要凭记忆。资料给出的基线测试显示,模型曾把 actions/checkout@v4、google-github-actions/auth@v2 当作当前主版本,而实际最新为 v7 和 v3。核验命令为:gh api repos/actions/checkout/releases/latest --jq .tag_name,应在本次编写时对每个 Action 执行。通常按主版本标签(@v7)固定,涉及生产凭据的工作流可按 commit SHA 固定以保障供应链卫生。
三是最小权限:每个 job 都写显式 permissions 块,从 contents: read 起步,只添加所需项(如 OIDC 需 id-token: write)。云认证仅用 OIDC 联合,不在 GitHub 存放长期云密钥;GCP 场景以 wendy-gcp-deployment 技能(references/github-oidc.md)为准,禁止 credentials_json / SA 密钥,包括作为回退或临时方案。必须存在 GitHub 的密钥(如无 OIDC 的 SaaS token)在启用 environments 时按环境级限定,不要仓库范围。
新工作流检查清单:可复用成熟 Action 的步骤都复用;本次会话核验每个 Action 版本;存在且最小的 permissions 块;云认证走 OIDC,无 credentials_json、无密钥 JSON;部署工作流加 concurrency: group,确保同一 ref 一次只部署一个;触发拆分默认分支到 dev,语义化标签(v*)到 prod。
资料另列出常见借口与反驳:凭习惯用旧版本即凭记忆,应执行核验;旧主版本会失去 runner 兼容性与安全修复,部分已弃用;留下 TODO 升级版本最终会随版本发布,应立即核验;用 curl 代替 Action 看似简单,但 Action 处理认证、重试与边界情况;credentials_json 临时使用会长期留存,WIF 引导只需几分钟,应先做。
限制:本技能主要面向 GCP 部署等场景有配套引用,但资料未提供完整示例代码与安装命令,具体实现细节暂未提供。