bk-cli-api
Installation
SKILL.md
bk-cli api — 原始 API 调用
直接对任意 BlueKing API Gateway 网关发起 HTTP 请求。
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../bk-cli-shared/SKILL.md。那里定义了认证、context、stage、timeout、header、body、tenant、dry-run 和 verbose 的共享规则;本 skill 只补充 bk-cli api 独有的原始请求构造细节。
何时优先使用本 Skill
- 用户已经知道要访问哪个
gateway_name、HTTP 方法和路径,希望直接发请求。 - 现有系统子命令还没覆盖目标接口,但用户仍想通过
bk-cli调试或调用。 - 用户想确认 URL、query、path placeholder、body 或自定义 header 最终会怎样落到请求里。
- 用户在排查“为什么这个请求打不通”,需要先看 dry-run、再看 verbose 输出、最后看 JSON envelope。
何时先看别的 Skill
- 如果用户还不知道有哪些网关、资源或 API 名称,先看
bk-cli-apigateway做发现和 Schema 浏览。 - 如果问题是认证、context、tenant、超时、header 覆盖优先级或其他共享请求规则,先看
bk-cli-shared。 - 如果已经有现成系统子命令能直接完成目标,而且用户并不关心底层 URL 细节,优先使用系统专属 skill,而不是默认退回原始 API。