name	bk-cli-paas
description	当需要通过 `bk-cli paas` 查询蓝鲸 PaaS 应用模块部署信息、部署任务结果，或触发支持多模块的部署动作时使用。

bk-cli paas — 蓝鲸 PaaS 应用部署能力

用于通过 bk-cli paas 调用蓝鲸 PaaS 应用部署相关 API。

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../bk-cli-shared/SKILL.md。共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 和通用请求规则；本 skill 只补充 paas 命令自己的语义与输入约定。

当前覆盖范围

当前 skill 覆盖三个命令：

get_deployment_result
module_env_released_info
deploy_with_module

输入约定

这三个接口都要求应用认证 + 用户认证 + 接口资源权限。调用前需要确保当前 context 的凭据同时满足应用身份和用户身份，并且对应应用已申请这些 API 的接口权限。
应用 ID 使用 PaaS 应用 app_code 或接口原始参数名 code。
模块名使用 PaaS 模块名称，默认模块通常为 default。
环境参数使用接口原始参数名：env 或 environment，常见值为 stag 或 prod。
deploy_with_module 是 YAML action，部署版本信息通过共享 --body '<json>' 传入；version_name 和 version_type 必填，revision 可选。执行时必须显式提供非空 --body。

Commands

`get_deployment_result`

bk-cli paas get_deployment_result \
  --app_code bk-demo \
  --module default \
  --deployment_id 12345

查询部署任务结果。
调用路径：GET /bkapps/applications/{app_code}/modules/{module}/deployments/{deployment_id}/result/

`module_env_released_info`

bk-cli paas module_env_released_info \
  --code bk-demo \
  --module_name default \
  --environment prod

查询应用模块环境部署信息。
调用路径：GET /bkapps/applications/{code}/modules/{module_name}/envs/{environment}/released_info/

`deploy_with_module`

bk-cli paas deploy_with_module \
  --app_code bk-demo \
  --module default \
  --env prod \
  --body '{"revision":"{commit_id}","version_type":"branch","version_name":"master"}'

触发支持多模块的 App 部署。
调用路径：POST /bkapps/applications/{app_code}/modules/{module}/envs/{env}/deployments/
请求体字段：revision 为源码仓库版本号，可选；version_name 为 branch 或 tag 名称，必填；version_type 为版本类型，必填，svn 支持 trunk/tag，git 支持 branch。

Más de este repositorio

mismo repositorio

create-bk-cli-system

TencentBlueKing/bk-cli

当需要为 bk-cli 扩展 system 能力时使用：无论是新增顶层 system、给已有 system 增加 action、还是为大 system 增加一层 subsystem，都应先使用此技能。技能会先检查目标 system/subsystem 是否已存在，遇到多模块 API 列表时先让用户在扁平 action 与一层 subsystem 两种命令形态中选择，再复用共享的 YAML/Go 选型、注册、测试和文档约定。

2026-06-222

test-bk-cli

TencentBlueKing/bk-cli

交互式测试和探索蓝鲸 CLI（bk-cli）命令。当用户希望测试 bk-cli、探索蓝鲸平台 API、验证 bk-cli 功能，或对蓝鲸各系统（cmdb、gse、job、sops、nodeman、devops 等）执行只读命令时，使用此 skill。触发短语包括"测试 bk-cli"、"test bk-cli"、"探索 bk-cli 命令"、"查看 bk-cli 接口"，或任何涉及 bk-cli 子命令测试的场景。

2026-06-222

bk-cli-api

TencentBlueKing/bk-cli

当需要通过 `bk-cli api` 对任意 BlueKing API Gateway 发起原始 HTTP 调用时使用，尤其适合现有系统子命令还没覆盖、需要精确复现某个 URL/query/path/body/header、先做 dry-run 验证请求构造，或直接调试请求输入与响应包络时。只要用户明确在做“原始 API 请求”而不是现成业务子命令，都应优先使用这个 skill。

2026-06-222

bk-cli-apigateway

TencentBlueKing/bk-cli

当需要通过 `bk-cli apigateway` 发现 BlueKing API Gateway 中所有公开网关、浏览某个网关公开的 API/资源列表、获取 OpenAPI/Schema、判断某个接口该怎么调用，或在 `apigateway` 子命令与 `bk-cli api` 之间做选择时使用。尤其是当用户还不知道或不确定该调用哪个网关、哪个公开接口、接口名可能是什么、只知道业务目标/关键词/资源名片段时，也应优先使用这个 skill，先搜索再确认，而不是直接猜测接口。

2026-06-222

bk-cli-bcs

TencentBlueKing/bk-cli

当需要通过 `bk-cli bcs` 调用 BCS API 时使用；当前主要覆盖 `bk-cli bcs cluster_manager` 下的集群、节点、节点组、节点模板、任务、模板配置和虚拟集群配额操作。

2026-06-222

bk-cli-cmdb

TencentBlueKing/bk-cli

当需要通过 `bk-cli cmdb` 使用 CMDB 相关系统子命令，或在 `cmdb` 子命令与 `bk-cli api bk-cmdb ...` 之间做选择时使用。尤其适合查询业务、拓扑、主机关系、主机转移，或排查 CMDB open API 请求构造是否正确的场景。

2026-06-222

bk-cli paas — 蓝鲸 PaaS 应用部署能力

用于通过 bk-cli paas 调用蓝鲸 PaaS 应用部署相关 API。

当前覆盖范围

当前 skill 覆盖三个命令：

get_deployment_result

module_env_released_info

deploy_with_module

输入约定

这三个接口都要求应用认证 + 用户认证 + 接口资源权限。调用前需要确保当前 context 的凭据同时满足应用身份和用户身份，并且对应应用已申请这些 API 的接口权限。

应用 ID 使用 PaaS 应用 app_code 或接口原始参数名 code。

模块名使用 PaaS 模块名称，默认模块通常为 default。

环境参数使用接口原始参数名：env 或 environment，常见值为 stag 或 prod。

deploy_with_module 是 YAML action，部署版本信息通过共享 --body '<json>' 传入；version_name 和 version_type 必填，revision 可选。执行时必须显式提供非空 --body。

Commands

get_deployment_result

bk-cli paas get_deployment_result \ --app_code bk-demo \ --module default \ --deployment_id 12345

查询部署任务结果。

调用路径：GET /bkapps/applications/{app_code}/modules/{module}/deployments/{deployment_id}/result/

module_env_released_info

bk-cli paas module_env_released_info \ --code bk-demo \ --module_name default \ --environment prod

查询应用模块环境部署信息。

调用路径：GET /bkapps/applications/{code}/modules/{module_name}/envs/{environment}/released_info/

deploy_with_module

bk-cli paas deploy_with_module \ --app_code bk-demo \ --module default \ --env prod \ --body '{"revision":"{commit_id}","version_type":"branch","version_name":"master"}'

触发支持多模块的 App 部署。

调用路径：POST /bkapps/applications/{app_code}/modules/{module}/envs/{env}/deployments/

请求体字段：revision 为源码仓库版本号，可选；version_name 为 branch 或 tag 名称，必填；version_type 为版本类型，必填，svn 支持 trunk/tag，git 支持 branch。