SuperAPI AI 工具集

diagnosing-ci-and-merge-bottlenecks

智能体与模型

查看项目

更新于 10-16 03:45

技能介绍

用途:把 PR 视为在流水线中流转的对象,定位 CI 与合并环节的瓶颈。调用三个具名 MCP 工具,无需写 SQL。

主要能力:pull-requests 返回打开及 date_from(默认 -30d)以来合并/关闭的 PR,含作者、仓库、状态、is_draft、标签、open_to_merge_seconds 与 CI 汇总(runs/passing/failing/pending),可用于筛选 CI 失败或 pending 的 PR、最久未合并的 PR、按作者或仓库分诊,以及合并耗时的中位数与 p95(勿用均值)。workflow-health 按窗口(默认近 30 天)给出每个工作流的 run_count、success_rate、p50_seconds、p95_seconds、last_failure_at,回答 CI 变快变慢及哪个工作流是长板;无内置趋势,需取两个相邻窗口对比,success_rate 与分位数仅覆盖已完成运行,窗口内无完成运行时为 null,比较前须判空。pr-lifecycle 展示单个 PR 的有序事件:opened、每个工作流运行的 CI started/finished 对、merged/closed,回答“PR N 卡在哪”,metric_quality 为 partial。

使用方式:按“聚合信号→确认→具体 PR”链路:先用 workflow-health 找慢/易失败的长板工作流,再用 pull-requests 确认其拖慢合并并列出受影响 PR,最后用 pr-lifecycle 打开代表性卡住 PR 展示时间缺口。输出先给一行结论再给支撑数字,多窗口或多工作流对比用简表并同时给中位数与 p95。

限制:open_to_merge_seconds 较粗,混合草稿与待审时间,只能称“open to merge”;CI 状态可能滞后,pending 视为未定而非失败;CI 仅按 head-SHA 关联最新提交;暂无评审、批准、单检查/作业与部署数据,不能据此推断评审行为或 DORA 指标;pull-requests 输出含机器人与草稿,按约定需自行过滤 author.is_bot 与 is_draft;返回结果有上限,truncated 为 true 时派生统计仅覆盖最新一页,需缩小 date_from。无聚合合并耗时工具与计数工具。不要将作者分桶做成排行榜。