SuperAPI AI 工具集

compare-gradle-builds

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:比较两次 Gradle 构建运行,定位构建耗时回归、缓存命中率变化和任务结果差异,并给出可执行的改进建议。

主要能力:通过 Tuist MCP 工具获取构建数据。使用 list_gradle_builds(account_handle、project_handle、git_branch、page_size) 查找分支上的构建;用 get_gradle_build(build_run_id) 获取单次构建详情;用 list_gradle_build_tasks 获取任务级明细,支持 outcome 与 cacheable 过滤。

比较维度:耗时(head 比 base 慢 10% 以上视为回归)、状态、本地与远程缓存命中数、执行任务数、可缓存任务数、缓存命中率、requested_tasks、Gradle 与 Java 版本。可计算缓存未命中差值 base_executed - head_executed。

用法:若提供构建 ID 或 URL,直接 get_gradle_build 获取;若提供分支名,先 list_gradle_builds 取最新一次再取详情。未提供 base 时默认项目默认分支(通常 main);未提供 head 时用 git rev-parse --abbrev-ref HEAD 检测当前分支。随后比较顶层指标,再下钻到任务级,找出命中转执行、执行转命中、新增失败、新任务和耗时显著增加的任务,按绝对耗时差排序。

诊断与输出:检查 requested_tasks 是否一致以判断可比性;缓存命中率下降常由依赖变更、构建配置变更或 Gradle 版本升级导致;还需比较 gradle_version、java_version、is_ci、git_branch、git_commit_sha、root_project_name。输出总结包含总体结论、耗时绝对与百分比变化、命中率变化、任务结果变化、状态变化、环境差异与改进建议。

限制:依赖 Tuist MCP 工具与可用的构建记录;未提供的内容暂未说明。