GitHub 返信テンプレート を設定して、レビュー意図を明確に伝えよう！

![ScreenShot 2024-04-11 16.18.07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/5d37db51-4bab-5c25-b1ba-d9fdfbf21463.png)

## 概要

レビューコメントを残す際にラベルやアラートを付けるどのような指摘なのかがより明確に伝わり、対応するべきか、そのままでいいのか判断しやすくなります。

## Gitシリーズ記事まとめ

https://qiita.com/ucan-lab/items/33c63a402f533aa92f3e

## 各種機能紹介

### Saved replies

https://docs.github.com/ja/get-started/writing-on-github/working-with-saved-replies/using-saved-replies

公式で用意されている、IssueやPull Requestを書く際に使用できる返信テンプレートを管理できます。

### Alert

https://github.blog/changelog/2023-12-14-new-markdown-extension-alerts-provide-distinctive-styling-for-significant-content/

マークダウン形式でアイコンと色で重要性を使い分けることができます。

### Shields.io

https://shields.io

公式の機能ではないですが、よくGitHubのREADMEなどにおしゃれなバッジを付ける時に利用されます。

## 返信テンプレートに登録する

https://github.com/settings/replies

こちらのリンクからテンプレートを設定します。
何でも登録できますが、私は下記の設定をしてます。ご参考にどうぞ

ラベルを使うのか、アラートを使うのかはぶっちゃけ好みだと思うので、自分が好きだと思う方を使ってみてください！

### ラベル

![must](https://img.shields.io/badge/review-must-critical.svg) 絶対に修正して欲しい項目がある場合に使います。 `Change Request` と一緒に使います。

```
![must](https://img.shields.io/badge/review-must-critical.svg)
```

![ask](https://img.shields.io/badge/review-ask-9b71ae.svg) 質問をして回答をもらいたいコメントをする時に設定しています。

```
![ask](https://img.shields.io/badge/review-ask-9b71ae.svg)
```

![imo](https://img.shields.io/badge/review-imo-yellow.svg) `In my opinion(私の意見では)` の略で私ならこう書くかもという意見。取り入れるかはレビュワー次第でokくらいのニュアンス

```
![imo](https://img.shields.io/badge/review-imo-yellow.svg)
```

![nits](https://img.shields.io/badge/review-nits-inactive.svg) `nitpick(些細な指摘)` typoや改行してないとか余計なスペースがあるとか。Approveするけど細かい部分を言いたい時に使います。特段返事も要らないよって時に使います。

```
![nits](https://img.shields.io/badge/review-nits-inactive.svg)
```

![good](https://img.shields.io/badge/review-good-success.svg) 良かった部分があったら積極的に利用しましょう。

```
![good](https://img.shields.io/badge/review-good-success.svg)
```

![tweet](https://img.shields.io/badge/review-tweet-9cf.svg) ツイート、つぶやき。お気持ち表明したい時などに使います。

```
![tweet](https://img.shields.io/badge/review-tweet-9cf.svg)
```

### アラート

![ScreenShot 2024-04-09 11.05.06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/71609ced-32e0-fa43-4446-6465053618e4.png)

```
> [!NOTE]
> コンテンツを流し読みする場合でも、ユーザーが知っておくべき役立つ情報。
```

![ScreenShot 2024-04-09 11.05.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/a151756f-356d-3e2d-3cb5-3a85548ed69c.png)

```
> [!TIP]
> 物事をより良く、より簡単に行うための役立つアドバイス。
```

![ScreenShot 2024-04-09 11.05.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/aab5c659-6ab6-0732-c454-25d6322a572c.png)

```
> [!IMPORTANT]
> ユーザーが目標を達成するために知っておく必要がある重要な情報。
```

![ScreenShot 2024-04-09 11.05.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/70953b42-c3fb-9cbf-4fbf-26915e10e78e.png)

```
> [!WARNING]
> 問題を回避するためにユーザーが直ちに注意を払う必要がある緊急情報です。
```

![ScreenShot 2024-04-09 11.05.51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/fc35175f-1588-2211-6362-3c1e3ede0231.png)

```
> [!CAUTION]
> 特定の行動のリスクやマイナスの結果についてアドバイスします。
```

## 使い方

IssueやPull Requestでコメントを書くときの Saved repliesのアイコンから使用できます。

![ScreenShot 2024-04-09 11.30.15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/9870a923-a6cd-8e10-9b3d-d152774178b9.png)

![ScreenShot 2024-04-09 11.32.00.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/b7da93eb-0a53-4dd7-8614-03272b304cc8.png)

選択するとコメント欄にテンプレートが貼り付けされます。

### 使い方(コマンド)

GitHub上のコメント入力フォームへ `/` を打つと`Slash commands`を呼び出せます。
`Saved replies` と入力する(saまで入力したら予測出てくる)と同じようにテンプレートを選択できます。

![ScreenShot 2024-04-11 16.45.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52879/856e5f12-1c78-6323-73ff-d0639f392e86.png)

### 使い方(ショートカット)

GitHub上のコメント入力フォームで `control` + `.` で`Saved replies` を呼び出せます。