mcpField
B
buildkite

buildkite

github.com/hjewkes云与 DevOps440 次安装35 周前更新
代码仓库

关于 buildkite

buildkite 是用于操作 Buildkite CI/CD 的命令行技能，适合查看流水线构建、作业与产物，也涵盖失败排查和 REST API 调用。

主要功能

  1. 01列出并查看构建及流水线
  2. 02触发指定分支的新构建
  3. 03查看作业日志与构建详情
  4. 04下载构建产物
  5. 05通过 API 调用 REST 端点

适用场景

  1. 01检查流水线最近的构建状态
  2. 02启动分支上的构建任务
  3. 03排查失败作业并查看日志
  4. 04下载测试报告等构建产物

安装

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

$npx skills add https://github.com/hjewkes/agent-skills --skill buildkite

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
bk-commands.md
build-debugging.md
troubleshooting.md
scripts/
buildkite
setup

详细介绍

Buildkite — CI/CD

设置

buildkite 包装器会自动检测是否为首次运行，并启动 scripts/setup。

构建操作

# List recent builds for a pipeline
buildkite build list --pipeline SLUG

# View build details
buildkite build view BUILD_NUMBER --pipeline SLUG

# Trigger a new build
buildkite build create --pipeline SLUG --branch main --message "Deploy"

# Rebuild a failed build
buildkite build rebuild BUILD_NUMBER --pipeline SLUG

# Cancel a running build
buildkite build cancel BUILD_NUMBER --pipeline SLUG

作业与日志操作

# List jobs for a build
buildkite job list --build BUILD_NUMBER --pipeline SLUG

# View job log output
buildkite job log JOB_ID

# Download build artifacts
buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG

流水线操作

# List all pipelines
buildkite pipeline list

# View pipeline configuration
buildkite pipeline view SLUG

故障调试工作流

构建失败时，请按以下顺序操作：

  1. 查找失败的构建： buildkite build list --pipeline SLUG --state failed

  2. 查看构建详情，了解哪些作业失败： buildkite build view BUILD_NUMBER --pipeline SLUG

  3. 获取失败作业的日志： buildkite job log JOB_ID

  4. 如果有可用的构建产物（测试报告等），请下载： buildkite artifacts download --build BUILD_NUMBER --pipeline SLUG

如需了解详细的调试模式，请加载 references/build-debugging.md。

输出约定

  • buildkite 默认输出 JSON；使用 jq 管道处理以供显示或提取。
  • 对于直接命令未涵盖的 REST API 端点，请使用 buildkite api。
  • 示例：buildkite api /v2/organizations/ORG/pipelines | jq '.[].slug'

参考文件

参考文件加载时机
references/bk-commands.md需要完整的 bk CLI 命令参考时
references/build-debugging.md需要深入调试构建失败时
references/troubleshooting.md遇到身份验证失败、CLI 错误或速率限制时

评论

支持 Markdown