SuperAPI AI 工具集

bitwarden-workflow-linter-rules

办公与效率

查看项目

更新于 10-15 20:06

技能介绍

用途:这是 Bitwarden 工作流 linter(bwwl)的规则参考,用于检查 GitHub Actions 工作流是否符合团队规范。规则共 10 条,分为“机械规则”(可直接自动修正)与“判断规则”(需暂停并询问用户)两类。

机械规则:name_capitalized 要求 workflow 或 job 的 name 值首字母大写;permissions_exist 要求显式声明 permissions:,优先写在 job 级;pinned_job_runner 将 runs-on 的非固定标签替换为固定版本,如 ubuntu-latest → ubuntu-24.04、windows-latest → windows-2022、macos-latest → macos-14;step_pinned 区分内部与外部 action:bitwarden/ 开头的内部 action 需固定到 @main(bitwarden/sm-action 形式任意 ref 均合规),外部 action 需固定到完整 40 位 commit SHA 并附版本注释,可用 gh api repos/{owner}/{repo}/commits/{ref} --jq '.sha' 解析 SHA,应用前需向用户展示 SHA 与验证链接并确认;underscore_outputs 要求多词输出名使用下划线;job_environment_prefix 要求 job 级环境变量用 SCREAMING_SNAKE_CASE;check_pr_target 要求使用 pull_request_target 的 job 限定到默认分支,需先确定仓库默认分支。

判断规则:name_exists 发现缺少 name: 时先问用户名称;step_approved 遇到未在 Bitwarden 批准列表中的 action 时,向用户提供加入批准列表、替换或删除三种选项,不自动更改;run_actionlint 对复杂错误需原样展示并请用户确认,简单的 shellcheck 风格警告可自动修复。

限制:具体批准列表与配置细节资料未完全提供。