用途:帮助创建、调试和测试 GitHub Actions 工作流与自定义 Action,面向 CI/CD 流水线搭建、工作流自动化和故障排查场景。
主要能力与规则:自定义 Action 必须先合并到 main 分支才能使用,首次合并后应从功能分支进行测试。调试时,在创建新 Action 或排查棘手问题时添加打印非敏感参数的调试步骤,并非每个工作流都需要。
效率原则:Action 会消耗 CI 分钟数,应谨慎而非反复试错。使用 gh run watch / gh pr checks --watch 实时跟踪运行;先读取失败作业日志再改代码;用调试步骤打印真实输入与 github 上下文;先用 act 在本地运行工作流以节省 CI 分钟;先规划最小复现,如单个作业、最小矩阵、窄触发条件,再逐步扩展。
关键注意事项:fork PR 中 pull_request 无法访问 secrets,pull_request_target 可以但绝不能在其中有写权限的情况下检出或执行 fork PR 代码,否则存在 RCE 风险;固定 Action 版本,使用 @v4 或 SHA 而非 @main;为 GITHUB_TOKEN 操作显式设置 permissions 块;作业间数据传递需使用 upload-artifact/download-artifact,文件不会在作业间自动持久化。
限制:资料未提供具体安装命令、收费信息或平台支持细节。