技能介绍

痛点：Tekton 流水线失败排查到底有多痛

当 Tekton 流水线在某个 Task 的某个 Step 突然挂掉时，传统的排查方式往往需要手工执行多条 kubectl 命令，穿梭于 TaskRun、PipelineRun 和 Pod 资源之间。你需要先找到失败的 PipelineRun，再定位对应的 TaskRun，最后深入到 Pod 日志里翻找报错信息。如果问题出在参数解析或 workspace volume 配置上，手动比对 spec 和实际运行状态更是费时费力。

工作原理：状态查询 + 日志提取 + 根因分析

该技能将这一过程自动化。核心工作流分为三步：

状态查询：通过 kubectl 和 Tekton Results API 拉取 PipelineRun 与 TaskRun 的状态信息，快速锁定失败节点。
日志提取：针对失败的 step container，直接提取对应的日志输出，避免手动进入 Pod 执行 kubectl logs。
根因定位：分析日志中的错误模式，识别 parameter resolution 错误（如引用了不存在的参数或资源），并检查 workspace volume 的配置是否符合预期。

当检测到 volume 路径不一致或权限问题时，技能会给出具体的修复建议，例如调整 workspaces 定义中的 subPath 或挂载路径。

适用边界

该技能依赖 kubectl 和 Tekton Results API 的可用性，要求运行环境已正确配置 kubeconfig 且 Tekton Results API 已部署。对于非 Tekton 编排的 CI/CD 系统，或问题发生在集群基础设施层面（如节点故障、网络策略阻断），该技能无法提供有效帮助。