用途:该技能是 Bitwarden GitHub Actions 命名约定的参考标准,专门覆盖工作流检查器 bwwl 无法检查的部分。它只审计三项约定,并明确不重复报告 linter 已覆盖的规则。
主要能力:
- job-id-kebab-case:要求 jobs: 下每个任务 ID 使用 kebab-case,此类 ID 是标识符而非标签,重命名前必须解析 needs:、needs.<job-id> 表达式及可复用工作流的 jobs.<job-id>.outputs 等引用。检查运行名称来自 name: 而非 ID,因此仅在任务缺少 name: 时重命名 ID 才可能影响必需状态检查。
- step-name-sentence-case:要求 steps: 下的 name: 使用句首大写并带祈使动词,专有名词与缩写保留原大小写。步骤名仅用于展示,可安全就地修改,是唯一允许代理直接应用的标准。
- workflow-file-naming:要求 .github/workflows/ 下文件为 kebab-case.yml,扩展名恒为 .yml;仅当工作流完全可复用(on: 只含 workflow_call 和 workflow_dispatch)时才加 _ 前缀,含 push、pull_request、schedule 等自动触发则为双用途,不加前缀。
使用方式与限制:该技能为只读(allowed-tools 只读),不执行编辑。发现偏差只应报告,不授权重命名;任务 ID 与文件名的重命名需先做引用排查(仓库内 grep 与 gh search code "<file>" --owner bitwarden),且文件重命名会破坏外部引用与运行历史分组,须由仓库所有者决定。重命名应全有或全无,不得并入无关改动。inputs、bash 变量大小写与制品名称无既定标准,遇到应如实指出而非自造约定。另提供建议性规范步骤名表,不属于强制标准。