GitHub Actions 失败检查与修复规划

为什么需要这个技能

当 GitHub Actions 在 PR 中失败时，开发者常陷入两个困境：一是日志冗长难以快速定位关键错误，二是修复操作可能绕过必要的审批流程直接修改代码。本技能聚焦解决这两个具体问题，通过自动化诊断与审批门控机制，让 CI 故障处理既高效又可控。

核心能力与工作方式

1. 失败检查快速定位

• 自动识别当前 PR 关联的所有失败检查项
• 通过 gh pr checks 命令获取最新检查结果
• 智能过滤无关日志，提取包含错误堆栈、构建失败原因的关键片段

2. 修复方案生成与审批

• 结合日志分析结果生成可操作的修复建议
• 所有修复操作在执行前必须经过用户显式确认
• 支持基于 gh-fix-ci 最佳实践的修复策略推荐

3. 关键步骤流程

1. 验证当前环境是否满足 gh CLI 认证要求
2. 解析 PR 元数据确定关联的 Actions 运行记录
3. 提取失败任务的详细日志输出
4. 生成结构化诊断报告并标注修复优先级
5. 在实施任何代码修改前触发审批流程

适用边界与注意事项

• 环境依赖：需要预装 Codex 运行时、GitHub CLI 及仓库级权限认证
• 安全约束：不自动提交修复代码，所有修改必须经过人工审批
• 故障模式：若日志分析失败或无法获取检查状态，技能会明确报错而非猜测
• 权限要求：需具备 repo 和 workflow scopes 的 GitHub 认证令牌
• 最佳实践：建议在敏感仓库使用时先通过 gh auth status 验证权限范围