mcpField
P
pipeline-variable-management

pipeline-variable-management

github.com/tencentbluekingDevelopment2.5k42 installsUpdated 2d ago
Repository

About pipeline-variable-management

A development skill for BK-CI pipeline variables, covering their path from definition and storage to runtime propagation, as well as field extensions and model conversion.

Key features

  1. 01Variable lifecycle and runtime flow
  2. 02Initialization, storage, and inheritance
  3. 03Field and type extensions
  4. 04Internal model and YAML conversion
  5. 05Compatibility and historical data checks

Use cases

  1. 01Investigating variable scope or propagation issues
  2. 02Extending variable fields or types
  3. 03Checking model conversion and legacy pipeline compatibility

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tencentblueking/bk-ci --skill pipeline-variable-management

After installing, type/pipeline-variable-managementin Claude Code to confirm it loaded.

Bundled filesreference/1-lifecycle.mdreference/2-extension.md

Details

From the project README

流水线变量管理

适用场景

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

不适用场景

  • 只是修改流水线模板或 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

Comments

Markdown supported