AgentSkillsCN

managing-devops-pipeline

管理蓝盾流水线的构建操作,包括查询构建历史、获取启动参数、查看构建状态、启动构建。当用户提及流水线、构建、部署、CI/CD、蓝盾或需要触发构建任务时使用。

中文原作
SKILL.md
--- frontmatter
name: managing-devops-pipeline
description: 管理蓝盾流水线的构建操作,包括查询构建历史、获取启动参数、查看构建状态、启动构建。当用户提及流水线、构建、部署、CI/CD、蓝盾或需要触发构建任务时使用。

蓝盾流水线管理

通过 MCP 工具 devops-prod-pipeline 管理蓝盾流水线构建。

核心概念

  • projectId:项目英文名(如 myproject
  • pipelineId:流水线 ID,以 p- 开头(如 p-abc123
  • buildId:构建 ID,以 b- 开头(如 b-xyz789

重要规则

启动构建前必须获得用户确认:在调用 v4_user_build_start 之前,必须向用户展示完整的构建入参并获得明确确认。未经用户确认,禁止执行构建操作。

常用工作流

1. 启动构建

code
步骤 1:获取启动参数 → devops-prod-pipeline:v4_user_build_startInfo
步骤 2:向用户展示构建参数,等待用户确认 ⚠️ 必须执行
步骤 3:用户确认后启动构建 → devops-prod-pipeline:v4_user_build_start
步骤 4:查看状态 → devops-prod-pipeline:v4_user_build_status

步骤 2 确认模板

code
即将启动构建,请确认以下参数:
- 项目:{projectId}
- 流水线:{pipelineId}
- 构建参数:
  {列出所有 body_param 的 key-value}

是否确认启动?

2. 查询构建历史

使用 devops-prod-pipeline:v4_user_build_list 获取历史记录。

常用流水线

用户配置的常用流水线,参阅 config.json

URL 解析规则:从 https://xxxxxx/console/pipeline/{projectId}/{pipelineId} 提取:

  • projectId/pipeline/ 后的第一段
  • pipelineId:以 p- 开头的最后一段

工具参考

获取构建历史:参阅 reference/build-list.md 获取启动参数:参阅 reference/build-startinfo.md 查看构建状态:参阅 reference/build-status.md 启动构建:参阅 reference/build-start.md

快速示例

查询最近构建

json
{
  "path_param": { "projectId": "your-project" },
  "query_param": { "pipelineId": "p-xxx", "page": 1, "pageSize": 10 }
}

启动一次构建

json
{
  "path_param": { "projectId": "your-project" },
  "query_param": { "pipelineId": "p-xxx" },
  "body_param": { "branch": "master" }
}

构建状态枚举

状态说明
SUCCEED成功
FAILED失败
CANCELED已取消
RUNNING运行中
QUEUE排队中
STAGE_SUCCESS阶段成功