Buildkite 管道性能分析器

问题：管道变慢了，但说不清慢在哪

Buildkite 流水线一旦变慢，团队的第一反应通常是"加机器"或"拆步骤"，但这类决策大多建立在猜测之上。真实的瓶颈往往藏在三个位置：某个步骤本身执行时间过长、构建代理在队列里排队太久、或者构件上传阶段吃掉了大把时间。三者对应的优化手段完全不同——前者要改步骤逻辑，中间要扩代理池或调整调度策略，后者则要检查上传路径与 buildkite-agent 的构件配置。

工作原理：从 API 数据到定位报告

这个技能不解析网页、也不读日志文件，而是直接调用 Buildkite 的 REST API 与 GraphQL API 拉取运行数据：

• 步骤耗时分析：逐条对比构建中各步骤的耗时，揪出执行时间异常的 job
• 队列等待时间：统计 agent 在队列中的等待时长，识别代理资源不足或调度倾斜
• 构件上传瓶颈：聚焦 artifact 上传环节，结合 buildkite-agent 元数据判断是传输带宽问题还是路径配置问题

最终输出一份优化报告，每条建议都对应具体的数据点，而不是泛泛的"优化建议"。

适用边界与注意点

技能的分析精度取决于 Buildkite API 返回的历史数据，也就是构建记录的完整程度。刚迁移到 Buildkite 的团队，建议先积累足够的构建样本再跑分析，趋势才有意义。

另外，SKILL.md 中明确提到无法自动提取基于源码的安装或使用说明。在敏感工作流中运行之前，请先查看上游项目，确认 API 访问范围与权限要求符合团队的安全策略。