SuperAPI AI 工具集

workflow-audit

办公与效率

查看项目

更新于 10-15 20:06

技能介绍

用途:对 GitHub Actions 工作流运行 Bitwarden 工作流 linter(bwwl),输出结构化审计报告。该技能严格只读,不修改、创建或删除任何文件;遇到不确定的发现会标注而非猜测。

主要能力:先检查 bwwl 是否可用(bwwl --version),未安装则停止并提示用户自行安装,不代为安装。随后确定范围:单个文件或目录只处理当前仓库;多个仓库(如 server、clients、android)需用户提供克隆基础目录,按 <base-dir>/<repo> 逐个查找,找不到则跳过并告知;未指定目标时默认检查当前目录 .github/workflows/ 下全部文件。对每个仓库执行 bwwl lint -f .github/workflows/,同时捕获 stdout 与 stderr,多仓库时说明当前正在检查哪个。

结果处理:按文件与规则分组,并参考 bitwarden-workflow-linter-rules 技能分类。机械类(可自动修复)包括 name_capitalized、permissions_exist、pinned_job_runner、step_pinned、underscore_outputs、job_environment_prefix、check_pr_target,以及单行 shell 修复的简单 run_actionlint 发现;判断类(需用户输入)包括 name_exists、step_approved 及复杂的 run_actionlint 发现。

报告:按仓库输出包含 File、Finding、Rule、Category 的汇总表,并统计机械类发现数、判断类发现数及无问题仓库数,最后提示用户可用 workflow-fix 技能应用修复。

限制:仅做审计与报告,不执行修复;依赖已安装的 bwwl;多仓库模式依赖本地克隆路径约定;具体规则细节需查阅配套规则技能。