Files
MaaAssistantArknights/docs/ja-jp/develop/issue-bot-usage.md
Loong f2ab4946ce ci: use lychee to check dead links (#9675)
* ci: use lychee to check dead links

* ci: comment on PR when dead links are found

* docs: fix broken links
2024-07-17 15:26:17 +01:00

73 lines
3.5 KiB
Markdown

---
order: 4
icon: bxs:bot
---
# Issue Botの使う方
Issue Botのアクションは[issue-checker](https://github.com/zzyyyl/issue-checker)になっており、設定ファイルである[issue-checker.yml][issue-checker]を利用します。
[issue-checker]: https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml
::: warning
Commitizenの仕様でコミットしていない場合、マージリクエストは`ambiguous`とマークされることに注意してください。
:::
## 特徴
### 自動通知
- `module`, `Client`, `ambiguous`, `translation required`などのラベルを Issue および Pull Request に追加します。
Issue Botは、キーワードを元にカテゴリーを追加します。
キーワードは[設定ファイル][issue-checker]を確認して下さい。
- 作成者が可視性がパブリックに設定されている MAA メンバーであるの Issue と Pull Request の場合、`MAA Team`ラベルを追加しました。
#### Issuesとコメント
- 必要なファイルが正常にアップロードされなかった Issue に `incomplete` タグを追加し、その旨を通知するコメントを追加します。
#### Pull Request
Issue Botは Pull Request のタイトルをチェックします。タイトルが以下のキーワードで始まっていない限り、 Pull Request は `ambiguous` としてマークされます。
- `build` `chore` `ci` `doc` `docs` `feat` `fix` `perf` `refactor` `rfc` `style` `test`
- `Merge` `merge` `Revert` `revert`
### 手動でトリガーを発動させる
キーワードを使用して問題を詳細に記述し、分類タグを自動的にトリガーし、次のコマンドの使用を減らします。
ただし、**自分の行動が Issue Bot を混乱させる可能性がありそうな内容の場合**は除きます。
#### Issues と Pull Request
- `Remove {LABEL_NAME}` でラベルを削除します。
- `Remove labels` で全てのラベルを削除します。
- `Skip {LABEL_NAME}` でラベルをスキップします。
- `Skip labels` で全てのラベルをスキップします。
#### Issueコメントと Pull Requestコメント
- `Skip {LABEL_NAME}` は、指定されたタイプのラベルが追加されないようにします。
- `Skip labels` は、ラベルが追加されないようにします。
- `fixed` ラベルを追加する場合、以下のいずれかのコマンドを使用します:<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}` と入力するとissueに `duplicate` ラベルを追加します。
- **あなたのコメントが Issue Bot を混乱させる可能性がある場合、下記の `skip` コマンドを追加できます。**
::: info 注意
ここの `COMMIT_HASH` は 40 文字の完全なハッシュです。
:::
#### Push
Push 中でも Commit 可能です:
- `fixed` ラベルは、コミットメッセージに以下のいずれかが含まれている場合に追加されます:
- `fix #{ISSUE_NUMBER}`
- `close #{ISSUE_NUMBER}`
- `fix https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/{ISSUE_NUMBER}`
- `close https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/{ISSUE_NUMBER}`