Buildkite 管道优化器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/buildkite-pipeline-optimizer-agent 到你的 AI 助手中。
技能介绍
要解决什么问题
Buildkite pipeline 越长,暴露的问题越多:串行步骤吃掉并行窗口、队列里挤满等待中的作业、代理利用率忽高忽低。CI 变慢后,团队常手动调 parallelism 或加几个代理,但缺少对整体流程的分析,改动往往只照顾局部,无法回答「哪里才是真正的瓶颈」。
技能如何工作
该技能面向 Buildkite pipeline YAML,结合 Buildkite REST API v2 与 GraphQL API 进行分析,核心能力包括:
- 解析 pipeline 结构,找出串行依赖形成的关键路径
- 识别拖慢整体节奏的瓶颈步骤
- 基于队列与代理的实际运行状态,给出并行性优化建议
- 建议代理队列重新平衡,缓解资源分配不均的问题
简单说,它先把 pipeline 的结构与运行时的队列状态放在一起看,再告诉你哪些地方可以更并行、哪些队列需要重新分配代理。
适用边界与注意点
- 需要能访问 Buildkite API(API key 与相应权限)
- 优化建议基于 API 可观测到的状态,不能替代对业务约束的判断
- 涉及生产 CI 配置变更前,建议先在测试 pipeline 上验证
- 无法自动提取基于源代码的安装或使用说明,运行前请查看上游项目
- 技能依据 Buildkite 官方文档(https://buildkite.com/docs)工作,API 行为变化可能影响分析结果
使用场景
- CI 构建时间突然拉长,需要定位 pipeline 中哪些串行步骤形成了关键路径。
- Buildkite 队列里作业长时间等待,需要根据代理分布判断哪条队列该增删代理。
- 准备调整 pipeline 并行度前,需要结合 YAML 结构和队列状态给出可执行建议。
适合人员
- CI/CD 工程师:负责 Buildkite pipeline,想缩短构建时间并定位瓶颈。
- 构建基础设施工程师:管理 Buildkite 代理队列,想让代理利用率更均衡。
- 技术负责人:看到 CI 排队变慢,需要基于 API 数据决定是否调整并行与队列。