Pipeline Variable Management
DevOps & Securitypipeline-variable-managementPipeline Variable Management is an Agent Skill for devops & security published in the TencentBlueKing/bk-ci repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
处理 BK-CI 流水线变量时使用，例如变量生命周期、运行时传递、跨任务更新、字段扩展和 YAML 与内部模型转换。当用户要改变量主链路而不是普通流水线步骤时优先使用。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/TencentBlueKing/bk-ci/blob/HEAD/ai/skills/pipeline-variable-management/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pipeline-variable-management, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
流水线变量管理
适用场景
- 理解变量从配置到运行时的完整流转
- 修改变量初始化、存储、继承或更新逻辑
- 扩展变量字段、变量类型或模型转换
- 排查变量传递、作用域或兼容性问题
不适用场景
- 只是修改流水线模板或 YAML 结构
- 只是修改插件定义，不涉及变量主链
- 只是处理普通前端表单展示
快速指导
- 这个 skill 关注的是“变量如何定义、落库、传递和演化”，不是一般参数使用说明。
- 变量问题通常分成两类：
- 生命周期与运行时流转：
reference/1-lifecycle.md - 字段扩展与模型转换：
reference/2-extension.md
- 生命周期与运行时流转：
- 排查变量问题时先判断是定义期问题，还是构建运行期问题。
- 改字段时要同时看内部模型、YAML 模型、转换器和兼容性。
- 如果变量变化影响流水线模型或 YAML 输入输出，再联动看
pipeline-model-architecture和yaml-pipeline-transfer。
高信号规则
- 变量既是配置数据，也是运行时状态的一部分
- 生命周期链路和字段扩展链路经常被混在一起，排查时要先拆开
- 新字段不是只加模型类，还要考虑转换、前后端和历史数据
关键陷阱
- 把运行期变量问题误判成模型字段问题
- 只改一个模型，不改转换器或兼容逻辑
- 只验证新构建，不验证历史数据和旧流水线
延伸阅读
- 生命周期与运行时流转：
reference/1-lifecycle.md - 字段扩展与模型转换：
reference/2-extension.md - 如果你在改流水线模型：再看
pipeline-model-architecture - 如果你在改 YAML 转换：再看
yaml-pipeline-transfer