Issue Bot의 동작은 issue-checker로 이루어지며, 설정 파일은 issue-checker.yml 입니다.

경고

Commitizen 규격으로 커밋하지 않는 경우, 풀 리퀘스트(Pull Request)가 ambiguous(애매모호한)로 표시됨에 주의해주세요.

기능

자동 알림

• 이슈와 풀 리퀘스트에 라벨을 추가합니다. 예: module, client, ambiguous, translation required 등 Issue Bot은 키워드를 기반으로 카테고리를 추가합니다. 키워드에 대해서는 설정 파일을 참조해주세요.
• MAA 공개 팀 멤버의 이슈와 풀 리퀘스트에 MAA Team 라벨을 추가합니다.

이슈와 이에 대한 코멘트

• incomplete(미완료) 라벨을 추가하고, 사용자에게 파일이 제대로 업로드되지 않았음을 알리는 코멘트를 추가합니다.

풀 리퀘스트

Issue Bot은 풀 리퀘스트의 제목을 확인합니다. 아래 키워드로 시작하지 않는 제목은 ambiguous(애매모호한)로 표시됩니다.

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

수동으로 트리거하기

아래 명령어 목록 대신 키워드로 Issue Bot을 트리거하는 것이 좋습니다. 단, 이로 인해 Issue Bot이 혼동될 수 있는 작업을 수행할 수 있음에 주의해야 합니다.

이슈와 풀 리퀘스트

• Remove {LABEL_NAME}은 라벨을 삭제합니다.
• Remove labels는 모든 라벨을 삭제합니다.
• Skip {LABEL_NAME}은 라벨을 건너뜁니다.
• Skip labels는 모든 라벨을 건너뜁니다.

이슈 코멘트와 풀 리퀘스트 코멘트

• Skip {LABEL_NAME}은 특정 유형의 라벨이 추가되지 않도록 합니다.
• Skip labels은 모든 라벨이 추가되지 않도록 합니다.
• fixed(수정함) 라벨을 추가하려면 다음 명령어 중 하나를 사용할 수 있습니다:¹
  • 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}는 이슈에 duplicate(중복) 라벨을 추가합니다.
• 코멘트가 Issue Bot을 혼동시킬 수 있는 경우 skip 작업을 추가할 수 있습니다.

참고

¹ 여기서 COMMIT_HASH는 8~40자 길이의 해시값이면 충분하며, 전체 40자일 필요는 없습니다.

Push

Issue Bot은 푸시 이벤트를 처리하지 않습니다. 커밋 메시지에 fix #{ISSUE_NUMBER}, close #{ISSUE_NUMBER} 등의 닫기 키워드가 포함되어 있으면, 해당 커밋이 기본 브랜치에 병합된 후 GitHub가 자동으로 해당 이슈를 닫지만, fixed 라벨은 추가되지 않습니다.

편집하기