Needs Triage

Automatically make new issues part of your triage process.

Quick Start

The Needs Triage bot monitors newly created issues and automatically adds a label of your choice to them. This means that looking at new issues in your triage process can be as simple as filtering on a label.

The bot can be asked to wait a little while before it looks at a new issue and it can also be told to not assign the label when specific conditions are met. For example, when the issue is already assigned or if it already has specific labels.

Placing the following configuration in .devbots/needs-triage.yml in your repository will instruct the bot to wait for three minutes after a new issue appears and then add a needs-triage label.

enabled: true
label: "needs-triage"
delay: 3

Configuration

The Needs Triage bot is configured by adding a .devbots/needs-triage.yml file to the repository where you installed the bot. This file is in the YAML format, and can contain the following configuration options:

enabled boolean whether the bot is active or not
label string the label to add on new issues
delay number the number of minutes to wait before looking at a new issue
skip_when_has_labels list of strings do not add a triage label when the issue has any of these labels. Use * to match any label
skip_when_has_assignee boolean do not add a triage label when the issue is assigned
skip_when_has_milestone boolean do not add a triage label when the issue is part of a milestone

Examples

Minimal Example

Placing the following configuration in .devbots/needs-triage.yml will make the bot immediately add a needs-triage label to newly created issues.

enabled: true
label: "needs-triage"

Delaying the Bot

Placing the following configuration in .devbots/needs-triage.yml will make the bot wait 5 minutes before the triage label is added.

enabled: true
label: "triage"
delay: 5

Checking for advanced conditions

Placing the following configuration in .devbots/needs-triage.yml will make the bot wait 5 minutes before the triage label is added. The bot will not do anything if the issue has already been assigned to someone or if the issue has a p1, p2 or p3 label assigned.

enabled: true
label: "triage"
delay: 5
skip_when_has_assignee: true
skip_when_has_labels: ["p1", "p2", "p3"]