How to use Issue Bot

The action of Issue Bot is issue-checker, with configuration file issue-checker.yml.

::: warning Your pull request will be marked as ambiguous when you are not committing with Conventional Commits specification. :::

Features

Auto Notification

Adds labels to issues and pull requests, e.g., module, client, ambiguous, translation required, etc. Issue Bot will add categories based on keywords. Please refer to the configuration file for the keywords.
Adds the MAA Team label to issues and pull requests for MAA public team members.

Issues and Their Comments

Adds label incomplete and comments to notify users that the files of their issues are not uploaded successfully.

Pull Request

Issue Bot will check the title of your pull request. Unless the title starts with one of the following keywords, the pull request will be marked as ambiguous.

build chore ci doc docs feat fix perf refactor rft style test i18n typo debug
Revert revert Release release

Triggering Manually

It is better to trigger Issue Bot with keywords instead of commands listed below, unless that you are aware that your action may confuse Issue Bot.

Issues and Pull Requests

Remove {LABEL_NAME} will delete a label.
Remove labels will delete all labels.
Skip {LABEL_NAME} will skip a label.
Skip labels will skip all labels.

Issue Comments and Pull Request Comments

Skip {LABEL_NAME} will make sure no labels of the specified type are added.
Skip labels will make sure no labels are added.
To add fixed label, you can use any of the commands below:<sup>1</sup>
- https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH} fixed
- fixed by https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH}
- {VERSION} fixed
- fixed by {VERSION}
Duplicate of #{ISSUE_NUMBER} will add duplicate label to the issue.
You can add some skip operations if your comment may confuse Issue Bot.

::: info Note <sup>1</sup> The COMMIT_HASH here can be 8 to 40 characters; it does not have to be the full 40 :::

Push

Issue Bot does not handle push events. If a commit message contains closing keywords such as fix #{ISSUE_NUMBER} or close #{ISSUE_NUMBER}, GitHub will automatically close the corresponding issue once the commit is merged into the default branch, but the fixed label will not be added.