gh-fix-ci

gh-fix-ci 技能为开发人员提供了一套自动化工作流程，用于直接从终端诊断并解决 GitHub Actions CI 流水线中的失败问题。通过整合 GitHub CLI (gh)，此代理程序会系统性地检查 Pull Request 的检查状态，识别失败的任务，并提取相关的日志片段以进行根本原因分析。它通过总结错误上下文并提供可执行的代码调整计划来简化调试过程，并在用户批准后进行实施。

此工具专为在以仓库为中心的工作环境中、需要保持 PR 生命周期高速度的工程师所设计。它有助于缩短从发现流水线失败到理解底层代码问题之间的差距，从而允许快速迭代，而无需切换上下文或手动解析庞大的 CI 日志。

• 自动列出失败的 PR 检查并检索 GitHub Actions 工作流的状态信息。

• 从单个任务日志中抓取并解析标准输出与错误流，以提取异常、堆栈追踪和测试超时等关键失败标记。

• 生成精简且专注于开发者的失败总结，突出显示最关键的日志片段。

• 通过在应用代码修改之前提出修复计划，促进结构化的修复生命周期。

• 利用 plan 技能来草拟和验证变更，确保所有修复都是经过深思熟虑并审查过的。

• 此技能需要配置正确的 GitHub CLI 环境，并具备提升后的仓库与工作流权限。

• 输入参数包括可选的仓库路径和 PR 编号或 URL；未提供具体目标时，默认使用当前分支的 PR。

• 它严格专注于 GitHub Actions；Buildkite 等外部服务会被识别并仅通过 URL 引用汇报。

• 可直接或通过代理程序使用提供的 inspect_pr_checks.py 脚本获取机器可读的 JSON 输出，便于进一步分析或与报表工具整合。

• 请确保拥有足够的权限来读取工作流执行；若沙盒环境阻止访问，请利用 require_escalated 标记来提供必要的授权。