Agent Skills
返回列表
💻

CNB Open API 集成

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f12a44b7/cnb-openapi-skills。

技能介绍

要解决什么问题

在 CNB(Cloud Native Build,cnb.cool)上查构建、Issue、PR 或仓库内容时,接口分散在多个服务路径下,且必须用 Bearer Token 和固定 Accept 头。若 Agent 只「写出 curl」或误用无法带认证的抓取工具,用户拿不到真实 JSON,页面链接也无法自动映射到对应 API。

技能如何工作

本技能把 CNB Open API 按服务域整理成可检索的接口索引(如 build、git、issues、members 等),并为常见控制台 URL 提供解析规则:例如 /{repo}/-/build/logs/{sn} 会先对应 GetBuildStatus,再按需拉取 stage / 日志列表。

执行层面有几条硬约束,文档里写得很清楚:

  • 通过 exec_command 实际跑 curl,用 $CNB_TOKEN 与 $CNB_API_ENDPOINT(默认 https://api.cnb.cool),请求头为 Authorization: Bearer … 与 Accept: application/vnd.cnb.api+json
  • 不要用 web_fetch 调需认证的 API
  • curl 需带 -w '%header{traceparent}';失败时 trace 只进日志便于排查,不要在回复里贴给用户
  • 收到链接或查询意图时 直接执行,而不是反复确认「要不要帮你调接口」

适用边界

技能覆盖 Open API 文档与调用约定,不替代你在 CNB 侧创建 Token、配置组织权限或理解各接口的业务语义。部分接口(如知识库查询)在文档中注明版本或方法变更(例如 POST 废弃、改 GET),以 SKILL 内说明为准。未配置 CNB_TOKEN 时,任何调用都会失败,需先在环境中补齐凭证。

使用场景

  • 同事发来 CNB 构建日志页链接,需要根据 `repo` 与 `sn` 查 **GetBuildStatus** 并拉 stage 明细定位失败步骤。
  • 要在 Issue 上追加评论并带附件,需按文档顺序申请上传 URL、PUT 上传后再 **PostIssueComment** 提交。
  • 合并前想对比两个 ref 的变更文件,需调用 **GetCompareCommits** 或打包下载 compare 变更归档。
  • 用户只给了仓库 Issue/PR 网页地址,需从 URL 解析 `number` 后调用 **GetIssue** 或 **GetPull** 取详情。

适合人员

  • 负责 CNB 流水线的 SRE,常在群里收到构建链接,要快速查状态与 runner 日志而不是手工点控制台。
  • 在脚本或 Agent 里触发/停止构建的发布工程师,需要 **StartBuild**、**StopBuild** 等接口的准确路径与请求头约定。
  • 管理组织仓库权限的平台管理员,需批量查询成员继承关系或调整 **ListMembersOfRepo** / 保护分支规则。
  • 对接 CNB 与内部工单系统的集成开发,要把页面 URL 自动转成 Open API 调用并返回结构化 JSON。