SuperAPI AI 工具集

actionlint

通用与其它

查看项目

更新于 10-16 01:10

技能介绍

用途:校验 .github/workflows/*.yml 工作流文件,发现语法错误、无效引用、表达式错误与安全问题,捕获通常只在运行时才暴露的错误。

主要能力:检查 actionlint 是否可用,缺失时引导安装;检测项目根目录的 .actionlintrc.yaml,否则回退到默认配置;校验语法、action 引用、表达式、shell 脚本与安全问题;按规则类别报告错误并给出修复建议。若安装了 shellcheck,actionlint 会自动校验 run: 块中的 shell 脚本(推荐但非必需)。

使用方式:先检查安装 actionlint --version 2>/dev/null。未安装可选:go install github.com/rhysd/actionlint/cmd/actionlint@latest(需 Go 1.22+);brew install actionlint;或下载二进制。校验全部工作流用 actionlint;指定文件用 actionlint .github/workflows/ci.yml;指定配置用 actionlint -config-file .actionlintrc.yaml;从标准输入校验用 cat workflow.yml | actionlint -。配置优先级为项目根 .actionlintrc.yaml,其次默认配置;无项目配置时可用默认配置创建临时文件再校验。

错误处理:安装失败应报告错误并给出补救步骤,不得跳过校验。校验失败时逐条报告文件与行号、错误类别(语法、action、表达式、runner、shell 等)、问题原因与具体修复,修正后重新校验。

限制:资料未提供具体规则清单、安全规则细节与完整修复示例,相关细节暂未提供。