用途:当任务涉及 bk-cli 通用规则时优先使用本 Skill,包括认证、context 切换、stage、timeout、header/body、tenant、dry-run、verbose;当请求失败但问题尚未明确落到某个系统命令时,也先用它统一排障。
主要能力与用法:先用本 skill 确认共享规则,再读系统专属 skill;系统专属命令未覆盖目标接口时用 bk-cli-api 处理原始调用。基础准备:bk-cli context init --bk_api_url_tmpl="https://bkapi.your-domain.com/api/{gateway_name}/";登录支持 bk-cli auth login --bk_app_code=X --bk_app_secret=Y --bk_token=Z、--bk_ticket=Z 或 --access_token=Z;自检用 bk-cli doctor 与 bk-cli doctor --offline。通用 flag 有 --context <name>、--stage <stage>(默认 prod)、--dry-run、--verbose、--insecure、--header 'Key:Value'(可重复)、--body '<json>'、--timeout <duration>。context 表示独立部署目标而非 stage,用 bk-cli context create/list/use 管理,名称须匹配 ^[a-z][a-z0-9-]*$,凭据写入当前 active context 或 --context 指定者;执行时 context 优先级为显式 --context、active context、本地 fallback,显式指定不存在会报错。tenant 是 context 默认值,单次覆盖用 --header 'X-Bk-Tenant-Id:<value>'。stdout 输出 JSON envelope,错误与 verbose 到 stderr;--header 必须含 : 且不能覆盖 Content-Type。超时默认 60s,bk-cli api 可用 --timeout 单次覆盖。认证检查:auth status 无凭据仍返回 ok: true,需看 data.has_credentials;auth check 无凭据返回 ok: false、error.code: no_credentials,exit code 1。
限制:本 skill 只讲共享规则与排障入口,不解释命令实现;扩展命令或修改契约需参考 AGENTS.md 与 docs/design.md。资料未提供具体版本、收费与平台支持信息。