mcpField
C
ci

ci

github.com/google-gemini云与 DevOps108.6k251 次安装今天更新
代码仓库

关于 ci

用于监控 GitHub Actions 并在本地复现 CI 故障的技能。它帮助 Agent 排查分支工作流，执行建议的测试或 lint 命令，并提供结构化故障报告。

主要功能

  1. 01自动在本地复现故障
  2. 02监控并发工作流状态
  3. 03快速生成结构化报告
  4. 04过滤日志噪声

适用场景

  1. 01在本地复现 CI 测试失败
  2. 02推送更改后检查工作流状态
  3. 03排查构建和作业故障

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/google-gemini/gemini-cli --skill ci

安装后在 Claude Code 中输入/ci确认已加载。

附带文件scripts/ci.mjs

详细介绍

CI 复现与状态

此技能可帮助 Agent 高效监控 GitHub Actions、排查失败，并将远程 CI 错误带到本地开发环境。默认启用自动复现失败，以加快修复流程。

核心功能

  • 自动复现：自动监控 CI，并在失败后立即在本地执行建议的测试或 lint 命令。
  • 实时监控：汇总显示当前分支上所有并行工作流的状态。
  • 快速失败排查：遇到首个作业失败时立即停止，并提供结构化报告。

工作流

1. CI 复现（replicate）- 默认

将此工作流作为监控 CI 并在本地自动复现失败的主要方式，以便立即排查和修复。

  • 行为：触发此工作流后，Agent 会监控 CI，并在检测到失败时立即自动执行所有建议的测试或 lint 命令（以 🚀 标记）。
  • 工具：node .gemini/skills/ci/scripts/ci.mjs [branch]
  • 查找：脚本会自动查找该分支最新的活动运行或近期运行。不要手动搜索运行 ID。
  • 目标：无需人工干预即可在本地复现失败，然后继续分析并修复代码。
1. CI 状态（status）

推送更改后，使用此工作流监控 CI，并在本地复现任何失败。

  • 工具：node .gemini/skills/ci/scripts/ci.mjs [branch] [run_id]
  • 查找：脚本会自动查找该分支最新的活动运行或近期运行。除非需要特定的历史运行，否则不要使用 `gh run list` 手动搜索 `run_id`。只需提供分支名称即可。
  • 步骤 1（监控）：使用分支名称执行工具。
  • 步骤 2（提取）：从输出中提取建议的 `npm test` 或 `npm run lint` 命令（以 🚀 标记）。
  • 步骤 3（复现）：在本地执行这些命令以确认失败。
  • 行为：每隔 15 秒轮询一次。检测到失败时，工具会退出并提供结构化报告，以及需要在本地运行的确切命令。

失败类别与操作

  • 测试失败：Agent 应运行建议的特定 npm test -w <pkg> -- <path> 命令。
  • Lint 错误：Agent 应运行 npm run lint:all 或特定软件包的 lint 命令。
  • 构建错误：Agent 应检查 tsc 输出或构建日志，以解决编译问题。
  • 作业错误：检查 gh run view --job <job_id> --log，排查基础设施或设置故障。

噪声过滤

底层脚本会自动过滤噪声（Git 日志、NPM 警告、堆栈跟踪冗余）。Agent 应关注工具提供的“结构化失败报告”。

评论

支持 Markdown