当前位置：首页 > news >正文

repo-automation-bots配置实战：如何为你的开源项目设置自动化标签和PR管理

news 2026/7/21 12:56:42

repo-automation-bots配置实战：如何为你的开源项目设置自动化标签和PR管理

【免费下载链接】repo-automation-botsA collection of bots, based on probot, for performing common maintenance tasks across the open-source repos managed by Google on GitHub.项目地址: https://gitcode.com/gh_mirrors/re/repo-automation-bots

想要让你的开源项目管理更高效吗？repo-automation-bots 是一个基于 Probot 的自动化机器人集合，专为 GitHub 仓库设计，能够自动执行常见的维护任务。本文将为你详细介绍如何配置和使用这个强大的自动化工具，让你的开源项目实现智能化的标签管理和 PR 分配。

什么是 repo-automation-bots？

repo-automation-bots 是由 Google 开发并维护的一套 GitHub 自动化机器人集合，它基于 Probot 框架构建。这套工具旨在帮助开源项目维护者自动化处理重复性任务，如自动标记问题、分配 PR、检查代码规范等。通过合理配置，你可以显著减少手动工作量，提高项目管理的效率和一致性。

如上图所示，repo-automation-bots 采用模块化设计，每个机器人都有特定的功能，可以根据项目需求灵活组合使用。

准备工作：安装与部署

1. 克隆仓库并安装依赖

首先，你需要将 repo-automation-bots 克隆到本地：

git clone https://gitcode.com/gh_mirrors/re/repo-automation-bots cd repo-automation-bots npm install

2. 创建 GitHub 应用

要使用这些自动化机器人，你需要在 GitHub 上创建一个新的 GitHub 应用：

访问 GitHub 开发者设置页面
点击 "New GitHub App"
填写应用名称和描述
设置 Webhook URL（本地开发时可使用 smee.io 代理）
配置必要的权限和订阅事件

3. 配置环境变量

创建.env文件并设置以下环境变量：

APP_ID=你的应用ID PRIVATE_KEY_PATH=私钥文件路径 WEBHOOK_SECRET=你的Webhook密钥

核心功能配置指南

自动标签管理配置 🏷️

自动标签功能是 repo-automation-bots 中最实用的功能之一。通过配置 .github/auto-label.yaml 文件，你可以实现智能化的标签管理。

产品标签配置

产品标签会根据仓库名称或问题标题自动识别并添加相应的 API 标签：

# 启用产品标签（默认开启） product: true

当用户创建标题包含 "spanner: 修复bug" 的问题时，系统会自动添加api: spanner标签。

语言标签配置

语言标签根据代码文件扩展名自动识别编程语言：

language: pullrequest: true labelprefix: 'lang:' extensions: js: ['JSON', 'ts'] python: ['py', 'pyx'] paths: .: 'js' test: .: 'python' fixtures: 'markdown'

这个配置会将所有.ts和.json文件标记为lang:js，test/目录下的文件标记为lang:python。

路径标签配置

路径标签根据文件所在目录结构添加标签：

path: pullrequest: true labelprefix: 'dir: ' paths: .: 'root' packages: auto-approve: 'auto approve' blunderbuss: 'blunderbuss'

当 PR 修改packages/auto-approve/目录下的文件时，会自动添加dir: auto approve标签。

PR 自动分配配置 👥

通过配置 .github/blunderbuss.yml 文件，你可以实现 PR 和问题的智能分配。

基本分配配置

assign_issues: - user1 - user2 assign_prs: - user3 - user4 ignore_authors: - dependabot - renovate

这个配置会将新问题和 PR 随机分配给指定的用户，同时忽略来自自动化工具（如 dependabot）的请求。

基于标签的智能分配

assign_issues_by: - labels: - 'api: spanner' to: - spanner-expert1 - spanner-expert2 - labels: - 'bug' to: - bug-triage-team1 - bug-triage-team2

这个高级配置允许你根据问题标签进行智能分配。例如，带有api: spanner标签的问题会自动分配给 Spanner 专家团队。

团队分配支持

assign_prs: - organization/backend-team - organization/frontend-team

你可以直接指定 GitHub 团队，系统会自动展开团队成员列表进行随机分配。

高级配置技巧

1. 组合使用多个机器人

repo-automation-bots 支持同时运行多个机器人。你可以在 packages/ 目录下找到所有可用的机器人模块：

auto-approve: 自动批准符合条件的 PR
blunderbuss: PR 和问题随机分配
cherry-pick-bot: 分支间自动 cherry-pick
conventional-commit-lint: 检查提交信息规范
merge-on-green: 所有检查通过后自动合并

2. 自定义标签前缀

你可以为不同类型的标签设置不同的前缀，提高标签的可读性：

language: pullrequest: true labelprefix: 'language: ' path: pullrequest: true labelprefix: 'directory: '

3. 多级路径标签

对于复杂的项目结构，可以配置多级路径标签：

path: pullrequest: true multipleLabelPaths: - labelprefix: "api: " paths: recaptcha_enterprise: "recaptchaenterprise" - labelprefix: "asset: " paths: recaptcha_enterprise: demosite: "flagship"

这个配置会为recaptcha_enterprise/demosite路径的文件同时添加api: recaptchaenterprise和asset: flagship两个标签。

实战配置示例

完整配置示例

下面是一个完整的实战配置示例，适用于中等规模的开源项目：

# .github/auto-label.yaml product: true language: pullrequest: true labelprefix: 'tech: ' extensions: javascript: ['js', 'ts', 'jsx', 'tsx'] python: ['py'] go: ['go'] java: ['java'] path: pullrequest: true labelprefix: 'area: ' paths: .: 'core' src: api: 'api' ui: 'frontend' utils: 'utilities' tests: 'testing' docs: 'documentation' requestsize: enabled: true

# .github/blunderbuss.yml assign_issues_by: - labels: - 'bug' to: - bug-triage-lead - senior-dev1 - labels: - 'feature' to: - feature-lead - product-owner assign_prs_by: - labels: - 'tech: javascript' to: - frontend-team-lead - js-expert - labels: - 'tech: python' to: - backend-team-lead - python-expert assign_issues: - project-maintainer assign_prs: - project-maintainer - core-contributor1 - core-contributor2 ignore_authors: - dependabot - github-actions