SuperAPI AI 工具集

labels-as-code

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:把单个 GitHub 仓库的标签集纳入版本控制,并让 PR 标签与改动的文件路径保持同步。

主要能力:用 .github/labels.yml 定义标签的名称、颜色、描述;用 .github/labeler.yml 定义路径到标签的规则,由 actions/labeler 在 PR 上执行;可选工作流 labels-sync.yml 按计划或推送同步,以及 labeler.yml 在每次 PR 时运行。

使用方式:先用 gh label list --json name,color,description 导出并与拟定的 labels.yml 比对差异,再提出默认标签集(type/、priority/、status/*、good first issue、help wanted、dependencies、breaking),询问用户是采用、裁剪还是沿用现有标签。同步可选一次性命令 gh label create "<name>" --color "<hex>" --description "<text>" --force,或 gh label clone <owner>/<repo>,或复制定时同步模板。路径自动打标签则复制 labeler.yml 与 pr-labeler.yml 模板并适配路径 glob。验证用 gh label list --json name,color,description,并开一个触碰匹配路径的 PR 确认标签生效,也可用 gh pr view <number> --json labels --jq '.labels[].name'。

限制:--force 只覆盖颜色和描述,不删除标签;删除必须逐标签获得明确授权后单独执行 gh label delete。crazy-max/ghaction-github-labeler 默认删除 YAML 中不存在的标签,模板已设 skip-delete: true。sync-labels 会移除不再匹配路径的标签,默认关闭。颜色用不带 # 的十六进制。重命名需用 gh label edit <old-name> --name <new-name>,--force 不会重命名。跨多仓库的标签策略应使用 /safe-settings,社区健康文件使用 /oss-hygiene。工作流模板固定 Node 24;自托管运行器需为 Actions Runner v2.327.1 或更高。使用前须重新核验所用 Action 的最新 SHA。部分具体版本与参数细节暂未提供。