pipeline-variable-management

处理 BK-CI 流水线变量时使用,例如变量生命周期、运行时传递、跨任务更新、字段扩展和 YAML 与内部模型转换。当用户要改变量主链路而不是普通流水线步骤时优先使用。

tencentblueking/bk-ci42 installsMITSynced Aug 26

Works with

Claude CodeCursorCodex CLIGitHub CopilotGemini CLI
---
name: pipeline-variable-management
description: 处理 BK-CI 流水线变量时使用,例如变量生命周期、运行时传递、跨任务更新、字段扩展和 YAML 与内部模型转换。当用户要改变量主链路而不是普通流水线步骤时优先使用。
license: MIT
---

# 流水线变量管理

## 适用场景

- 理解变量从配置到运行时的完整流转
- 修改变量初始化、存储、继承或更新逻辑
- 扩展变量字段、变量类型或模型转换
- 排查变量传递、作用域或兼容性问题

## 不适用场景

- 只是修改流水线模板或 YAML 结构
- 只是修改插件定义,不涉及变量主链
- 只是处理普通前端表单展示

## 快速指导

1. 这个 skill 关注的是“变量如何定义、落库、传递和演化”,不是一般参数使用说明。
2. 变量问题通常分成两类:
   - 生命周期与运行时流转:`reference/1-lifecycle.md`
   - 字段扩展与模型转换:`reference/2-extension.md`
3. 排查变量问题时先判断是定义期问题,还是构建运行期问题。
4. 改字段时要同时看内部模型、YAML 模型、转换器和兼容性。
5. 如果变量变化影响流水线模型或 YAML 输入输出,再联动看 `pipeline-model-architecture` 和 `yaml-pipeline-transfer`。

## 高信号规则

- 变量既是配置数据,也是运行时状态的一部分
- 生命周期链路和字段扩展链路经常被混在一起,排查时要先拆开
- 新字段不是只加模型类,还要考虑转换、前后端和历史数据

## 关键陷阱

- 把运行期变量问题误判成模型字段问题
- 只改一个模型,不改转换器或兼容逻辑
- 只验证新构建,不验证历史数据和旧流水线

## 延伸阅读

- 生命周期与运行时流转:`reference/1-lifecycle.md`
- 字段扩展与模型转换:`reference/2-extension.md`
- 如果你在改流水线模型:再看 `pipeline-model-architecture`
- 如果你在改 YAML 转换:再看 `yaml-pipeline-transfer`

More Accessibility skills

← All Accessibility skills

Check your AI visibility

One URL in, a 0–100 score and the exact fixes out.

RUN THE CHECK

Browse all the tools

15 tools across six categories
13 of them never send your data anywhere

Free · No signup · No trial clock

SEE THE DIRECTORY