run-gemini-cli实战：3步实现GitHub Issues自动分类与优先级排序

【免费下载链接】run-gemini-cli A GitHub Action invoking the Gemini CLI. 项目地址: https://gitcode.com/gh_mirrors/ru/run-gemini-cli

run-gemini-cli是一款强大的GitHub Action工具，能够帮助开发者自动调用Gemini CLI，实现GitHub Issues的智能分类与优先级排序，大幅提升项目管理效率。通过简单配置，即可让AI自动处理Issue分类、标签添加和优先级评定，让团队更专注于代码开发而非繁琐的管理工作。

准备工作：快速部署run-gemini-cli环境

在开始实现Issues自动分类之前，需要先完成run-gemini-cli的基础部署。首先确保你的GitHub仓库已正确配置Actions权限，然后通过以下命令克隆项目代码：

git clone https://gitcode.com/gh_mirrors/ru/run-gemini-cli

进入项目目录后，推荐参考官方文档docs/authentication.md完成Gemini API密钥的配置，这是实现AI功能的核心前提。同时，确保你的环境满足package.json中指定的依赖要求，可通过npm install命令快速安装所需依赖。

第一步：配置Issue分类规则文件

run-gemini-cli通过TOML配置文件定义Issue分类逻辑。在项目的examples/workflows/issue-triage目录中，提供了完整的配置示例。你需要创建或修改gemini-triage.toml文件，定义分类标签与匹配规则：

[classification]
  [classification.bug]
    pattern = "bug|error|crash|broken|not working"
    priority = "high"
    labels = ["bug", "needs-triage"]
  
  [classification.feature]
    pattern = "feature|request|enhancement|new"
    priority = "medium"
    labels = ["enhancement"]
  
  [classification.question]
    pattern = "question|help|how to|support"
    priority = "low"
    labels = ["question", "support"]

上述配置定义了三种常见Issue类型：bug（高优先级）、feature（中优先级）和question（低优先级），每种类型通过正则表达式匹配Issue标题和描述内容。你可以根据项目需求，在gemini-triage.toml中扩展更多分类规则。

第二步：创建GitHub Action工作流文件

在仓库的.github/workflows目录下创建工作流文件（如gemini-issue-triage.yml），配置触发条件和执行步骤。参考examples/workflows/issue-triage/gemini-triage.yml的示例，核心配置如下：

name: Gemini Issue Triage
on:
  issues:
    types: [opened, edited]

jobs:
  triage:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run Gemini CLI Triage
        uses: ./  # 使用本地run-gemini-cli action
        with:
          gemini-api-key: ${{ secrets.GEMINI_API_KEY }}
          config-path: examples/workflows/issue-triage/gemini-triage.toml
          issue-number: ${{ github.event.issue.number }}

该配置实现了在Issue被创建或编辑时自动触发分类流程。关键参数包括Gemini API密钥（通过GitHub Secrets安全存储）、配置文件路径和当前Issue编号。如需定时批量处理Issues，可参考gemini-scheduled-triage.yml添加定时触发规则。

第三步：验证与优化自动分类效果

工作流部署后，创建一个新Issue进行测试，标题可包含"bug: login page crashes on mobile"。run-gemini-cli会自动调用Gemini AI分析Issue内容，匹配到bug分类规则后，添加"bug"和"needs-triage"标签，并设置优先级。

你可以通过查看GitHub Actions运行日志来调试配置问题，也可以在gemini-scheduled-triage.toml中调整AI模型参数：

[model]
name = "gemini-pro"
temperature = 0.3  # 降低随机性，提高分类稳定性
max-tokens = 500

根据实际使用情况，逐步优化分类规则和模型参数，使自动分类准确率达到项目需求。对于复杂场景，可参考docs/best-practices.md中的高级配置技巧。

总结：自动化带来的团队效率提升

通过run-gemini-cli实现GitHub Issues自动分类与优先级排序，平均可减少团队40%的Issue管理时间。该工具的核心优势在于：

• 零代码配置：通过TOML和YAML文件即可完成所有设置，无需编写复杂脚本
• AI智能分析：利用Gemini强大的自然语言理解能力，准确识别Issue意图
• 灵活扩展：支持自定义分类规则、优先级算法和标签体系
• 无缝集成：完全符合GitHub Actions标准，与现有工作流自然融合

想要进一步探索run-gemini-cli的更多功能，可以查看examples/workflows目录下的PR自动审核、代码生成等场景示例，或将其与项目的extensions.md中描述的扩展机制结合，实现更复杂的自动化流程。

【免费下载链接】run-gemini-cli A GitHub Action invoking the Gemini CLI. 项目地址: https://gitcode.com/gh_mirrors/ru/run-gemini-cli