cnb-skill 提供对 CNB(Cloud Native Build)平台 OpenAPI 的完整交互能力,用于操作用户在 CNB 上的各类资源。
用途:当用户要求对 CNB 上的资源进行操作时,使用该技能完成。例如查询某个仓库的 Issue 列表,或对某个仓库的 Issue、PR 进行评论。
主要能力:可管理组织、仓库、Issue、PR、合并请求、流水线、发布、制品等资源,具体支持范围需通过帮助信息确认。
使用方式(核心原则为严格基于帮助信息,不作推测):
- 执行 cnb --help 获取最新使用方式与模块列表。
- 用 cnb --module <模块名> -help 查看模块帮助。
- 用 cnb --module <模块名> --tool <工具名> --help 查看工具参数。
- 按参数执行:cnb --module <模块名> --tool <工具名> --path '{"参数": "值"}' --query '{"参数": "值"}' --data '{"参数": "值"}'。 其中 --module、--tool 为必填;--path、--query、--data 为可选 JSON 字符串;--help 可选。
- 结果处理:返回标准 JSON,包含 status、trace、header、data。列表请求的 header 会给出 x-cnb-page、x-cnb-page-size、x-cnb-total,便于获取分页与总条数,避免循环请求。status 在 200~299 时仅返回 data;>=300 时返回 status 与 trace。状态码含义:200 成功、400 参数错误、401 未授权、403 禁止访问、404 资源不存在、500 服务器内部错误。 下载图片异常时,可使用:node scripts/core/index.js assets get-imgs --help。
限制:需先获取帮助信息,禁止臆断用法;文档未提供具体模块与工具清单、鉴权配置方式及可用平台版本,暂未提供。