workflow-audit

规则

• 此技能严格为只读。 不要修改、创建或删除任何文件。
• 标记不确定之处。 如果某项发现存在歧义，请在报告中注明，不要猜测。

步骤 1：验证前提条件

检查 bwwl 是否可用：

bwwl --version

如果找不到该命令，请停止并告知用户，必须先安装 bwwl 才能继续。不要尝试安装它。

步骤 2：确定范围

解析用户的请求，确定要检查哪些内容：

• 单个文件或目录（例如 .github/workflows/build.yml 或 .github/workflows/）：仅在当前仓库中操作。
• 多个仓库（例如“server、clients、android”）：依次在每个仓库中操作。询问用户仓库的克隆基础目录。对于每个仓库，在 <base-dir>/<repo> 下查找本地克隆。如果找不到克隆，请告知用户并跳过该仓库。
• 未指定目标：检查当前目录中 .github/workflows/ 下的所有文件。

步骤 3：运行检查器

对范围内的每个仓库，运行：

bwwl lint -f .github/workflows/

捕获标准输出和标准错误。如果要操作多个仓库，请说明正在检查哪个仓库。

步骤 4：解析并分类发现

根据检查器输出，生成结构化的发现列表。按文件和规则分组。参考 bitwarden-workflow-linter-rules 技能，对每项发现进行分类：

机械性（可自动修复）：

• name_capitalized、permissions_exist、pinned_job_runner、step_pinned、underscore_outputs、job_environment_prefix、check_pr_target
• 简单的 run_actionlint 发现（单行 shell 修复）

需判断（需要用户输入）：

• name_exists、step_approved、复杂的 run_actionlint 发现

步骤 5：报告

为每个仓库输出一张摘要表：

文件	发现	规则	类别
...	...	...	...

包含统计总数：机械性发现、需判断的发现，以及没有问题的仓库数量。

告知用户可以使用 workflow-fix 技能，根据这些发现应用修复。