技能介绍

解决什么问题

在 Jenkins 里维护声明式流水线时，很多错误都要等到 Jenkinsfile 提交后、Job 构建时才暴露：stage 之间少了 agent、缩进错位、指令拼写不规范、Declarative 语法与 Jenkins 版本不兼容等。这些问题一旦进入主干，轻则构建失败，重则影响发布节奏。团队通常希望在 Code Review 阶段就把这些机械性问题拦住，而不是靠 CI 报错来兜底。

这个技能如何工作

这个技能面向 Jenkins 声明式流水线的静态校验与修复，核心能力包括：

调用 Jenkins Pipeline Linter API 的 /pipeline-model-converter/validate 端点，对 Jenkinsfile 进行结构校验。
自动修复常见的 Declarative 语法问题，减少人工逐行排查的成本。
检测阶段中缺失的 agent 指令，并尝试补齐，避免运行时报 agent 相关错误。

使用流程很直接：把待校验的 Jenkinsfile 交给技能，它会把内容适配到 Linter API 的输入格式并发起校验；根据 API 返回的诊断信息，技能再执行可自动修复的项，最后输出修复后的流水线或仍需人工确认的问题列表。

适用边界与注意点

它适合做 PR 前后的快速预检，以及开发日常自检，但不能替代 Jenkins 运行时环境验证。修复能力只覆盖常见语法与缺失指令，语义是否正确、构建逻辑是否合理，仍需由流水线作者和 CI 环境共同确认。调用前需要能访问 Jenkins 的 Pipeline Linter API；如果 Jenkins 版本较旧或网络不可达，技能可能无法返回完整结果。对于涉及自定义共享库、复杂矩阵构建或条件分支的问题，建议结合单元测试和真实 Job dry-run 一起看。