# CI 修复（GitHub 操作） ## 目标 * 以最小的、可审查的差异快速获得 CI 绿色。 * 使用“gh”查找失败的运行、检查日志/工件、重新运行作业并确认修复。 ## 要求的输入（如果缺失） * Repo (`OWNER/REPO`) 以及这是 PR 还是分支构建。 * 运行失败 URL/ID（或 PR 号/分支名称）。 *“绿色”意味着什么（所需的工作流程？允许不稳定的重新运行？）。 * 任何约束（无工作流程编辑、无权限更改、无强制推送等）。 ## 工作流程（清单） 1. 确认`gh`上下文 * 验证：`gh 验证状态` * 仓库：`gh 仓库视图 --json nameWithOwner -q .nameWithOwner` * 如果需要，请在所有命令中添加 `-R OWNER/REPO`。 * 如果“gh”未安装或未经过身份验证，请告诉用户并询问是否安装/身份验证或通过手动粘贴日志/运行 URL 继续。 2. 查找失败的运行 * 如果您有运行 URL，请提取运行 ID：`.../actions/runs/`。 * 否则： * 最近失败：`gh run list --limit 20 --status failure` * 分支失败：`gh run list --branch --limit 20 --status failure` * 工作流程失败：`gh run list -w <工作流程> --limit 20 --status failure` * 在浏览器中打开：`gh run view --web` 3. 从日志中拉取信号 * 作业/步骤概述：`gh run view --verbose` * 仅失败的步骤：`gh run view --log-failed` * 作业的完整日志：`gh run view --log --job ` * 下载工件：`gh run download -D .artifacts/` 4. 确定根本原因（首选最小的解决方案） * 使用 `references/ci-failure-playbook.md` 来了解常见模式和安全修复。 * 首选：确定性代码/配置修复 > 工作流管道修复 > 重新运行 flake。 5. 实施修复（最小差异） * 更新代码/测试/配置和/或 `.github/workflows/*.yml`。 * 保持更改范围仅限于失败的作业/步骤。 * 如果更改触发器/权限/秘密，请指出风险并获得明确的确认。 6. 在 GitHub Actions 中验证 * 仅重新运行失败：`gh run rerun --failed` * 重新运行特定作业（注：作业 **databaseId**）： `gh run view --json jobs --jq '.jobs[] | {名称，数据库Id，结论}'` * 观察直到完成：`gh run watch --compact --exit-status` * 手动触发：`gh工作流程运行<工作流程> --ref <分支>` ## 安全注意事项 * 避免“pull_request_target”（以及任何运行带有秘密的不受信任的分叉代码的更改），除非用户明确请求它并了解安全权衡。 * 保持工作流程“权限：”最低权限；不要“只是为了让它通过”而扩大代币访问范围。 ## 可交付成果（粘贴在聊天/PR 中） * **摘要：** ... * **运行失败：** <链接/id>（作业/步骤） * **根本原因：** ... * **修复：** ... * **验证：**命令+新的运行链接/id * **注意事项/风险：** ...

修复Ci

包含技能