コメントとスレッド

GitLabでは、コメント、スレッド、コードの変更提案を通じてコミュニケーションを奨励しています。コメントはMarkdownとクイックアクションをサポートしています。

次の2種類のコメントを使用できます:

• 標準コメント。
• スレッド内のコメント。これは解決できます。

コミット差分コメントでコードの変更を提案できます。ユーザーは、UIからその提案を承認できます。

コメントを追加できる場所

次のような場所にコメントを作成できます:

• コミットの差分。
• コミット。
• デザイン。
• エピック。
• イシュー。
• マージリクエスト。
• スニペット。
• タスク。
• OKR。
• Wikiページ。

各オブジェクトには、最大5,000件のコメントを付けることができます。

メンション

GitLabインスタンス内のユーザーまたはグループ（サブグループを含む）を、@usernameまたは@groupnameでメンションできます。GitLabは、メンションされたすべてのユーザーにto-doアイテムとメールを通知します。ユーザーは、通知設定でこの設定を自分で変更できます。

GitLabでは、自分（現在の認証済みユーザー）へのメンションが別の色で強調表示されるため、どのコメントが自分に関係するのかをすばやく確認できます。

すべてのメンバーにメンションする

コメントと説明では、@allのメンションは避けてください。@allは、プロジェクト、イシュー、またはマージリクエストの参加者だけでなく、そのプロジェクトの親グループのすべてのメンバーもメンションするためです。メンションされたユーザーが、このメール通知とto-doアイテムを受け取った結果、スパムであると受け取ってしまう可能性があります。

この機能フラグを有効にすると、コメントと説明に@allと入力すると、すべてのユーザーをメンションする代わりにプレーンテキストになります。この機能を無効にすると、Markdownテキスト内の既存の@allメンションは変更されず、リンクとして残ります。今後の@allメンションのみがプレーンテキストとして表示されます。

通知とメンションは、グループの設定で無効にできます。

イシューまたはマージリクエストでグループをメンションする

コメントでグループをメンションすると、グループのすべてのメンバーのto-doアイテムがto-doリストに追加されます。

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. マージリクエストの場合は、コード > マージリクエストを選択して、マージリクエストを見つけます。
3. イシューの場合は、Plan > イシューを選択して、イシューを見つけます。
4. コメントで、@の後にユーザー、グループ、またはサブグループのネームスペースを入力します。たとえば、@alex、@alex-team、または@alex-team/marketingなどです。
5. コメントを選択します。

GitLabは、すべてのグループおよびサブグループメンバーのto-doアイテムを作成します。

サブグループのメンションの詳細については、サブグループをメンションするを参照してください。

マージリクエストの差分にコメントを追加する

マージリクエストの差分にコメントを追加すると、次の場合でも、これらのコメントは保持されます:

• リベース後に強制プッシュする。
• コミットを修正する。

コミット差分コメントを追加するには、次の手順に従います:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. コード > マージリクエストを選択して、マージリクエストを見つけます。
3. コミットタブを選択し、コミットメッセージを選択します。
4. コメントを開始します:
   • ファイル全体にコメントするには、コメントするファイルを見つけ、ファイルヘッダーで、このファイルにコメントする（ ）を選択します。
   • 特定の行にコメントするには、コメントする行番号を見つけます。行番号にカーソルを合わせるて、コメント（ ）を選択します。複数の行を選択するには、コメント（ ）アイコンをドラッグします。
5. コメントを入力します。
6. コメントを送信します:
   • コメントをすぐに送信するには、今すぐコメントを追加を選択するか、キーボードショートカットを使用します:
     • macOS: Shift+Command+Enter
     • その他すべてのOS: Shift+Control+Enter
   • レビューを完了するまでコメントを公開しないようにするには、レビューを開始を選択するか、キーボードショートカットを使用します:
     • macOS: Command+Enter
     • その他すべてのOS: Control+Enter

コメントは、マージリクエストの概要タブに表示されます。

コメントは、プロジェクトのコード > コミットページには表示されません。

メールを送信してコメントに返信する

「メールで返信」が構成されている場合は、メールを送信してコメントに返信できます。

• 標準コメントに返信すると、別の標準コメントが作成されます。
• スレッドコメントに返信すると、スレッドに返信が作成されます。
• イシューのメールアドレスにメールを送信すると、標準コメントが作成されます。

メールの返信で、Markdownとクイックアクションを使用できます。

コメントを編集する

自分のコメントはいつでも編集できます。メンテナー以上の役割を持つユーザーは、他のユーザーが作成したコメントも編集できます。

コメントを編集するには、次の手順に従います:

1. コメントで、コメントを編集（ ）を選択します。
2. 編集を行います。
3. 変更を保存を選択します。

メンションを追加するためにコメントを編集する

デフォルトでは、ユーザーをメンションすると、GitLabはそのユーザーのto-doアイテムを作成し、通知メールを送信します。

既存のコメントを編集して、以前になかったユーザーメンションを追加すると、GitLabは次のようになります:

• メンションされたユーザーのto-doアイテムを作成します。
• 通知メールは送信されません。

ディスカッションをロックしてコメントを防止する

イシューまたはマージリクエストでパブリックコメントを防止できます。その場合、プロジェクトメンバーのみがコメントを追加および編集できます。

前提要件:

• マージリクエストでは、少なくともデベロッパーの役割が必要です。
• イシューでは、プランナー以上のロールが必要です。

イシューまたはマージリクエストをロックするには、次の手順に従います:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. マージリクエストの場合は、コード > マージリクエストを選択して、マージリクエストを見つけます。
3. イシューの場合は、Plan > イシューを選択して、イシューを見つけます。
4. 右上隅で、マージリクエストのアクションまたはIssue actions（イシューアクション）（ ）を選択し、ディスカッションのロックを選択します。

GitLabが、システムノートをページの詳細に追加します。

イシューまたはマージリクエストを再度開くには、クローズされたイシューまたはマージリクエストで、ロックされたすべてのディスカッションのロックを解除する必要があります。

機密アイテムに関するコメント

機密アイテムにアクセスする権限を持つユーザーのみが、そのアイテムに関するコメントの通知を受け取ります。アイテムが以前に機密にされていなかった場合、アクセス権のないユーザーが参加者として表示されることがあります。これらのユーザーは、アイテムが機密である間は通知を受け取りません。

通知を受け取ることができるユーザー:

• ロールに関係なく、アイテムに割り当てられたユーザー。
• 少なくともゲストロールを持つ場合、アイテムを作成したユーザー。
• アイテムが属するグループまたはプロジェクト内で、少なくともプランナーロールを持つユーザー。

内部メモを追加する

公開イシュー、エピック、Wikiページ、またはマージリクエストに追加された情報を保護するには、内部メモを使用します。内部メモは公開コメントとは異なります:

• 少なくともレポーターの役割を持つプロジェクトメンバーのみが、内部メモを表示できます。
• 内部メモを通常のコメントに変換することはできません。
• 内部メモへのすべての返信も内部ノートです。
• 内部メモには内部メモバッジが表示され、公開コメントとは異なる色で表示されます:

前提要件:

• プロジェクトのレポーターロール以上を持っている必要があります。

内部メモを追加するには、次の手順に従います:

1. イシュー、エピック、Wikiページ、またはマージリクエストのコメントテキストボックスに、コメントを入力します。
2. コメントの下にあるこれを内部メモにするを選択します。
3. 内部メモを追加を選択します。

イシュー全体を機密としてマークしたり、機密マージリクエストを作成したりすることもできます。

コメントのみを表示する

コメントが多いディスカッションでは、ディスカッションをフィルターリングして、コメントまたは変更履歴（システムノート）のみを表示します。システムノートには、説明の変更、他のGitLabオブジェクトでのメンション、またはラベル、担当者、マイルストーンへの変更が含まれます。GitLabは設定を保存し、表示するすべてのイシュー、マージリクエスト、またはエピックに適用します。

1. マージリクエスト、イシュー、またはエピックで、概要タブを選択します。
2. ページの右側にある並べ替えとフィルタリングドロップダウンリストから、次のフィルターを選択します:
   • すべてのアクティビティーを表示: すべてのユーザーコメントとシステムノートを表示します。
   • コメントのみ表示: ユーザーコメントのみを表示します。
   • 履歴のみ表示: アクティビティーノートのみを表示します。

アクティビティーの並べ替え順序を変更する

既定の順序を逆にして、上部に最新のアイテムが並べ替えられたアクティビティーフィードを操作します。GitLabはローカルストレージに設定を保存し、表示するすべてのイシュー、マージリクエスト、またはエピックに適用します。イシューとエピックは同じ並べ替え設定を共有しますが、マージリクエストはそれぞれ個別の設定を保持します。

アクティビティーの並べ替え順序を変更するには、次の手順に従います:

1. イシューを開くか、マージリクエストまたはエピックで概要タブを開きます。
2. アクティビティーの見出しまでスクロールします。
3. ページの右側で、並べ替え順序を変更します:
   • Issues and epics（イシューとエピック）: 並べ替えとフィルタリングドロップダウンリストから、新しい順または古い順を選択します。
   • マージリクエスト: 並べ替え方向の矢印ボタンを使用して、ソート順: 昇順（古い順、デフォルト）またはソート順: 降順（新しい順）に切り替えます。

説明の変更履歴を表示する

履歴にリストされている説明への変更を確認できます。

変更を比較するには、以前のバージョンと比較を選択します。

コメントしているユーザーにイシューを割り当てる

コメントをしたユーザーにイシューを割り当てることができます。

1. コメントで、More Actions（その他のアクション）（ ）メニューを選択します。
2. コメント作成者にアサインするを選択します。
3. コメンターの割り当てを解除するには、ボタンをもう一度選択します。

標準コメントに返信してスレッドを作成する

標準コメントに返信すると、スレッドが作成されます。

前提要件:

• 少なくともゲストの役割が必要です。
• イシュー、マージリクエスト、またはエピックにいる必要があります。コミットとスニペットのスレッドはサポートされていません。

コメントに返信してスレッドを作成するには、次の手順に従います:

1. コメントの右上隅にあるコメントに返信（ ）を選択して、返信セクションを表示します。
2. 返信を入力します。
3. 返信または今すぐコメントを追加を選択します。

GitLabは、上部のコメントをスレッドに変換します。

コメントに返信せずにスレッドを作成する

標準コメントに返信せずにスレッドを作成できます。

前提要件:

• 少なくともゲストの役割が必要です。
• イシュー、マージリクエスト、コミット、またはスニペットにいる必要があります。

スレッドを作成するには、次の手順に従います:

1. コメントを入力します。
2. コメントの下のコメントの右側にある下矢印（ ）を選択します。
3. リストから、**スレッドを開始します。**を選択します。
4. もう一度**スレッドを開始します。**を選択します。

スレッドを解決する

会話を終了したい場合は、スレッドを解決できます。

前提要件:

• エピック、イシュー、タスク、目標、主な成果、またはマージリクエストにいる必要があります。
• 少なくともデベロッパーロールを持っているか、イシューまたはマージリクエストの作成者である必要があります。

スレッドを解決するには、次の手順に従います:

1. スレッドに移動します。
2. 次のいずれかを実行します:
   • 元のコメントの右上隅で、スレッドを解決にする（ ）を選択します。
   • 最後の返信の下にある返信欄で、スレッドを解決にするを選択します。
   • 最後の返信の下にある返信欄にテキストを入力し、スレッドを解決にするチェックボックスを選択して、今すぐコメントを追加を選択します。

マージリクエストは、次のような、より柔軟なスレッド管理オプションを提供します:

• 新しいイシューに未解決のスレッドを移動します。
• すべてのスレッドが解決されるまで、マージを禁止する。

Duo Chatでイシューのディスカッションを要約する

イシューに関するディスカッションのサマリーを生成します。

概要を見る

前提要件:

• イシューを表示する権限が必要です。

イシューのディスカッションのサマリーを生成するには、次の手順に従います:

1. イシューで、アクティビティーセクションまでスクロールします。
2. サマリーを表示を選択します。

イシューのコメントが、最大10個のリスト項目に要約されます。回答に基づいてフォローアップの質問をすることができます。

データ使用量: この機能を使用すると、イシューのすべてのコメントのテキストが大規模言語モデルに送信されます。