This is a GitHub Action that can be used to manage issues in a project.
# .github/workflows/update-issue.yaml
name: Update issue
on:
issues:
pull_request:
types: [opened, closed, reopened]
jobs:
update-issue:
runs-on: ubuntu-latest
steps:
- uses: theintern/[email protected]
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
project: Development
auto-add: true
triage-column: Triage
triage-label: needs-triage
todo-column: To do
working-column: In progress
done-column: Done| Property | Required | Value |
|---|---|---|
github-token |
Yes | A GitHub API token (GITHUB_TOKEN is available by default) |
project |
Yes | The project being managed |
auto-add |
No | If true, all new issues are added to the project |
triage-column |
No | Column name for new, unassigned issues |
triage-label |
No | Label to apply to new issues |
triaged-labels |
No | A comma separated list of labels; the presence of any of them marks an issue as already-triaged |
todo-column |
No | Column name for triaged issues |
working-column |
No | Column name for in-progress issues |
done-column |
No | Column name for completed issues |
Only issues should be added to a project, not PRs. Linked PRs are accessible through the issue cards.
Note that any rule below that mentions an optional config property will only be executed if that property is defined.
Rules:
- If
auto-addis true, new issues will be added totriage-columnand havetriage-labelset, unless an issue has a label intriaged-labels, in which case it will be moved totodo-column - Issues in
triage-columnwill be moved totodo-columnwhentriage-labelis removed - Issues that are in
todo-columnortriage-columnwill be moved toworking-columnwhen they are assigned - When a PR is opened that links to an issue in
triage-columnortodo-column, that issue will be moved toworking-column - An issue in
working-columnthat is unassigned with be moved totodo-columnn - Closed issues are moved to
done-column - Re-opened issues are moved to
working-columnif they are assigned, or totodo-columnif not