1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | buildkite-buildkite-skills | — |
| 项目自述名称 | Buildkite Skills | GitHub README |
| 作者/维护者 | Buildkite（CI/CD 平台厂商），官方组织仓库 | GitHub API |
| 来源链接 | https://github.com/buildkite/skills | — |
| 许可证 | MIT | GitHub API + LICENSE 原文核对 |
| GitHub Stars | 14 | GitHub API |
| Forks | 3 | GitHub API |
| 最新版本 | 1.0.0（.claude-plugin/plugin.json） |
GitHub |
| 安装方式 | npx skills add buildkite/skills；Cursor 应用市场搜索安装；Kiro Powers 面板；或手动复制 skills/ 子目录 |
官方 README |
2. 功能介绍与亮点
Buildkite Skills 是 Buildkite 官方发布的技能包，教 AI 编程 Agent 正确使用 Buildkite 这套 CI/CD 平台。技能包含 6 个子技能：
- buildkite-pipelines：
pipeline.yml的 step 类型、缓存、并行、动态流水线、matrix build、插件与 artifact 写法 - buildkite-migration：从 GitHub Actions、Jenkins、CircleCI、Bitbucket Pipelines、GitLab CI 迁移到 Buildkite 的规划与
bk pipeline convert用法 - buildkite-preflight：用
bk preflight对本地未提交改动跑一次 CI 构建 - buildkite-agent-runtime：
buildkite-agent在运行中的 job 里做 annotate、artifact 上传、meta-data 读写、OIDC 令牌获取、分布式锁等操作 - buildkite-cli：
bk命令行管理 build、job、pipeline、secret、artifact 与鉴权 - buildkite-api：REST/GraphQL API、webhook 与鉴权
亮点：官方在 2026 年 4 月 30 日发布公告正式宣布该技能包上线；仓库有 10 位真实贡献者持续维护，最近一次提交发生在 2026 年 7 月 22 日；每个技能都遵循统一的 frontmatter 与内容规范（CONVENTIONS.md），并明确划分“技能之间互不重叠”的边界表，避免同一问题被多个技能重复覆盖。
3. 适用场景
所属分类：DevOps 与基础设施
面向正在使用或计划迁移到 Buildkite 的工程师：编写与调试 .buildkite/pipeline.yml、在 job 内使用 buildkite-agent 子命令、用 bk CLI 管理构建、调用 Buildkite API 做自动化，或把现有 CI 配置从其他平台迁移过来。技能被设计为“教 Agent 判断力”而非罗列文档——例如该用哪种 step 类型、何时用 OIDC 而非静态 token。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持，README 提供
.claude/skills/手动安装步骤与插件市场路径 - Codex：✅ 支持，
CONVENTIONS.md明确将 Codex 列入技能输出面向的 Agent 名单，可通过npx skills add通用安装器接入 - OpenClaw：❓ 未验证，仓库全文未提及
- Hermes Agent：❓ 未验证，仓库全文未提及
（另外文档中提到 Cursor、Copilot、Windsurf、Gemini CLI、Kiro 亦受支持，但均非本次评估的四个目标生态，仅供参考。）
5. 推荐理由
CI/CD 配置是 Agent 最容易“看似正确、实则踩坑”的领域之一——错的 step 类型、过期的插件参数、该用 OIDC 却用了静态密钥。这套技能由平台官方维护，内容与 Buildkite 产品变化同步更新，不会像社区二手教程一样滞后。安装成本只有一条命令，六个子技能按“流水线写作 / 迁移 / 本地预检 / 运行时操作 / CLI / API”分工清晰，用多少装多少。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | Buildkite 官方组织仓库，2026-04-30 官方 changelog 正式发布公告；GitHub star 数（14）尚不高，但出品方是 Buildkite 这家一线 CI/CD 平台厂商本身 |
| 可用性 | 9 | 一条命令安装，支持手动复制/插件市场/Kiro等多种路径；文档含贡献规范与质量检查清单；10位贡献者持续维护，最近一次提交为 2026 年 7 月 22 日；免费层可用无需强制付费 |
| 安全性 | 9 | 抽查的 SKILL.md 均为纯文档型内容（命令语法、YAML 示例、判断逻辑），未发现可疑指令或数据外发；MIT 开源可审计；官方组织出品，License 与维护记录均清晰 |
综合评分：9.0
安全检查清单：①涉及的 shell/CLI 操作均是用户自己执行 bk/buildkite-agent 官方命令，技能本身不做自主代码执行，权限范围可解释；②无额外网络外联，API 交互均通过 Buildkite 官方接口；③ buildkite-api 技能涉及鉴权字段，但只是教学写法，未见凭据明文硬编码或非常规存储方式；④抽查的技能文档未见提示注入或混淆代码；⑤官方组织账号，无造假迹象；⑥License 明确（MIT）；⑦最近一次提交为 2026 年 7 月 22 日，维护活跃。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| CircleCI 官方 Codex 插件（openai/plugins 仓库内 circleci 子目录） | CircleCI 官方为 OpenAI Codex 定制的诊断构建失败、优化 CI 配置插件 | 服务的是不同的 CI/CD 平台（CircleCI vs Buildkite），且只面向 Codex 单一 Agent；Buildkite Skills 用通用 Agent Skills 格式覆盖更多 Agent |
| mcncl/buildkite-claude-skill（社区个人项目） | 面向 Buildkite 的非官方 Claude 技能，2025 年 10 月起未再更新 | 由官方仓库的贡献者之一在官方技能发布前独立开发；官方版本发布后功能更全（6个子技能 vs 单一技能）且持续维护，社区版本已停滞 |
8. 用户评价
该技能目前在第三方 Agent Skills 目录（如 claude-plugins.dev、mcpmarket.com）已被收录展示，但尚未见到具名用户在社区平台留下的评价。
9. 其他补充
无。
10. 安装使用方式
方式一（推荐）：在项目根目录运行
npx skills add buildkite/skills方式二：Cursor 用户可在应用市场搜索 “Buildkite Skills”，或运行 /add-plugin 搜索 “Buildkite”。
方式三（手动复制）：
git clone https://github.com/buildkite/skills.git
mkdir -p .claude/skills
cp -r skills/buildkite-pipelines .claude/skills/
cp -r skills/buildkite-cli .claude/skills/
# 按需复制其余子技能：buildkite-preflight / buildkite-agent-runtime / buildkite-api / buildkite-migration安装后无需重启，Agent 会根据对话内容（如提到 pipeline.yml、bk 命令、buildkite-agent 子命令等）自动触发对应技能，无需手动调用技能名。
11. 注意事项
- 使用前提是已有 Buildkite 账号；虽有永久免费层（3 个并发 job、90 天日志留存），但技能本身教的是 Buildkite 特有概念（如
buildkite-agent子命令、动态流水线上传），离开 Buildkite 平台无法复用 - OpenClaw、Hermes Agent 的兼容性未在仓库中找到证据，如在这两个生态使用需自行验证
- 技能内容假设使用者已了解基础 YAML 与 CI/CD 概念，不适合完全没有 CI 经验的用户直接上手