GitHub Actions：自动添加议题与拉取请求到项目

GitHub Actions：自动添加议题与拉取请求到项目

add-to-project Automate adding issues and pull requests to GitHub projects 项目地址: https://gitcode.com/gh_mirrors/ad/add-to-project

项目介绍

此开源项目名为actions/add-to-project，由GitHub Actions团队维护，致力于自动化将当前议题或拉取请求添加到GitHub项目中。请注意，该行动不支持传统的GitHub项目。通过自定义工作流程，您可以实现当议题或拉取请求被打开、重开或标签化时，自动把这些工单归类到指定的项目看板中，增强项目管理效率。项目采用MIT许可协议，允许广泛的应用。

项目快速启动

要迅速启用此功能，您需在您的仓库中设置一个GitHub Actions工作流。以下示例展示了如何配置，使得带有“bug”或“needs-triage”标签的新议题自动添加至特定项目：

name: 添加问题到项目面板
on:
  issues:
    types: [opened]
jobs:
  add-to-project:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/add-to-project@vX.X.X
        with:
          project-url: https://github.com/{orgName}/{repoName}/projects/{projectNumber}
          github-token: ${{ secrets.ADD_TO_PROJECT_PAT }}
          labeled: bug, needs-triage
          label-operator: OR

在这个脚本中，确保替换{orgName}、{repoName}以及{projectNumber}为实际值，并且创建一个名为ADD_TO_PROJECT_PAT的仓库秘密来存储具有正确权限的个人访问令牌。

应用案例与最佳实践

案例一：基于标签自动分类

• 目标：自动将标记为“bug”的议题分配到“待修复”列。
• 操作：配置动作响应议题带有“bug”标签的事件，并设定label-operator为OR，确保只要议题含有该标签即执行添加操作。

案例二：多个条件筛选

• 场景：仅当拉取请求被标记为“需要复审”（needs-review）且大小为“XL”时，将其加入项目看板。
• 实施：利用labeled: needs-review, size/XL并设置label-operator为AND以精确匹配。

最佳实践

• 使用细粒度的个人访问令牌（PAT），限制其权限至必要的最低级别。
• 针对不同类型的工单逻辑创建专用的工作流，保持工作流的清晰与高效。
• 定期更新所使用的GitHub Action版本，以获取最新功能和安全更新。

典型生态项目

虽然该项目本身就是生态的一部分，增强GitHub项目的管理能力，但具体的典型生态项目指的是那些广泛应用此Action的仓库。社区中的许多开发团队通过集成actions/add-to-project，实现了高效的项目管理和自动化流程，尤其是在软件开发、产品管理和质量保障领域。这些实践不仅优化了内部协作流程，也提升了对外开源项目贡献者的体验，形成了良好的开源协作生态。然而，具体实例名称及详情需结合实际情况搜索相关仓库的.github/workflows目录查看实际应用案例。

通过上述步骤与实践，您可以充分利用GitHub Actions的能力，提高项目管理的自动化程度，进而提升团队协作效率。

add-to-project Automate adding issues and pull requests to GitHub projects 项目地址: https://gitcode.com/gh_mirrors/ad/add-to-project