跳转至

GitHub Actions Retry Policy

生成时间:2026-06-14T10:47:02.335189+00:00

数据分类:synthetic_internal_demo。本报告把 GitHub Actions Run Ledger 的脱敏 failure annotation handoff,转成 PR/Docs Health Loop 可消费的 retry policy decision。

Case 来源说明

本报告使用的失败样例来自团队实际协作中遇到的 ALPC91 镜像仓库 GitHub Actions 依赖下载失败。进入仓库后,它不再作为一次邮件故障排查继续处理,而是被脱敏成 fixture / demo / benchmark,用来验证 Harness 是否能把实践问题沉淀为可复跑的工程能力。

沉淀规则是:先保留真实问题类型、触发条件和工程后果,再移除 run id、job URL、完整日志、完整 SHA 和外部响应正文,最后只把安全 category、review 结论、retry gate、retry budget 和 escalation 写入 Runtime Projection。

汇总

  • decision 数:1
  • resolved review 数:1
  • pending review 数:0
  • auto retry allowed 数:1
  • hold for review 数:0
  • manual fix required 数:0
  • max auto retry budget:1
  • 安全输出泄漏:0

决策表

Item Review Categories Retry Action Gate Max Retry Escalation
semrev-github-actions-failure-annotation-policy resolved dependency_download_error auto_retry_once_after_dependency_source_check dependency_source_config_is_current_or_fix_committed 1 human_review_if_retry_fails_or_dependency_source_is_untrusted

当前结论

  1. dependency_download_error 不是无限重试信号;只有在依赖源配置已经确认或修复提交存在时,才允许自动重试一次。
  2. 第二次仍失败时必须回到 Semantic Review Queue 或依赖源配置检查,不能让 Loop 在同一失败点反复轮询。
  3. test、lint、docs build、permission 和 unknown workflow failure 默认不自动重试,必须先修复或人工 triage。
  4. policy 输出只保留 category、gate、retry budget 和 escalation,不暴露原始 run/job URL、完整日志或完整 SHA。

下一步

  1. 接入真实 GitHub adapter 后,用 run attempt、rerun API 结果和最新 annotation 更新同一 policy decision。
  2. 让 PR/Docs Health LoopRun 持续读取该 decision;自动重试预算耗尽时生成新的 Semantic Review event,并把原因写回项目 Timeline。