# 自分の変更を他のユーザーが確認できるようにする

コラボレーションを改善し、レビューを合理化し、変更に関するチームの情報をチームに伝える、明確で焦点を絞ったプルリクエストを作成します。

pull request を作成すると、他のユーザーに変更を確認し、フィードバックを提供するよう求められます。 焦点が明確で、分かりやすく、追いやすいプルリクエストは、レビュアーがより良いフィードバックを提供し、自信を持って提案を行うのに役立ちます。

## 変更を簡単に確認できるようにする

明確なコンテキストは、校閲者が変更された内容と重要な理由をすばやく理解するのに役立ちます。 前後を減らし、レビューをより速くし、チームが変更の最も重要な部分に集中するのに役立ちます。

### 小さな pull request を書く

小規模で焦点を絞ったプル要求は、簡単に確認でき、マージの安全性が高まります。 レビュー担当者は、変更の目的を理解し、問題をより迅速に特定し、後でプロジェクトの履歴に従うのに役立ちます。

変更が大きくなると、それぞれが 1 つの目的に対応する小さなプル要求に分割することを検討してください。

### コンテキストとガイダンスを提供する

明確なタイトルと説明は、レビュー担当者が問題、アプローチ、結果を理解するのに役立ちます。 適切なコンテキストでは、多くの場合、変更が必要な理由、変更された内容、レビュー担当者が特別な注意を払う必要がある場所が説明されます。

ガイダンスは、プル要求が多数のファイルに触れる場合や、特定のレビュー順序が必要な場合に特に役立ちます。 たとえば、レビュー担当者に最も重要なファイルを最初に指定したり、最も役に立つフィードバックの種類を説明したりできます。
GitHub Copilotを使用して、プル要求の概要を生成することもできます。

### 最初に独自の pull request を確認する

他のユーザーにレビューを依頼する前に、独自の pull request を確認すると、間違いを早期にキャッチするのに役立ちます。 また、レビュアーに、そのプル リクエストがレビュー可能な状態であることを示します。

自己レビューには、差分の読み取り、偶発的な変更のチェック、関連するビルドまたはテストの実行の確認が含まれます。

### セキュリティをレビューする

セキュリティ レビューは、プル要求がマージされる前のリスクをキャッチするのに役立ちます。 これは、プル要求が依存関係、認証、アクセス許可、ワークフロー、または機密データを処理するコードを変更する場合に特に重要です。

GitHub では、依存関係の変更、依存関係のレビュー結果、 code scanning チェックなど、プル要求のセキュリティ情報を表示できます。 これらのシグナルを使用して、早期に問題を解決したり、レビュー担当者の注意を必要とするリスクを強調したりすることができます。

リポジトリで code scanning がチェックとして設定されている場合、GitHub Copilotの自動修正機能 はセキュリティ脆弱性の修正を提案できます。

## チームに常に情報を提供する

Pull requests はドキュメント コードの変更以上のことを行うことができます。また、作業の状態についてチームに通知し続ける方法でもあります。 進捗が見える化されると、個別の進捗確認を減らし、全員の認識を揃えやすくなります。

### GitHub Copilotを使用して pull request の概要を生成する

> \[!NOTE]
> Copilot 機能には Copilot プランが必要です。 「[GitHub Copilotの計画](/ja/enterprise-cloud@latest/copilot/get-started/plans)」を参照してください。

Copilot では、 GitHubで pull request の概要を生成できます。 生成された概要は、レビュー担当者が主な変更を理解するのに役立ちますが、慎重に確認し、自分だけが知っているコンテキストを追加する必要があります。

概要は、変更の目的を説明し、重要なファイルを呼び出し、レビュー担当者が詳しく調べる必要がある内容を強調表示する場合に最も役立ちます。

### 関連する issue やプロジェクトへのリンク

pull request を問題またはプロジェクトに接続すると、作業がより大きなプロジェクトにどのように適合するかを示します。 リンクは、レビュー担当者が優先順位を理解し、進捗状況を追跡し、関連するディスカッションを見つけるのに役立ちます。

マージ後にプル要求で問題を閉じる必要がある場合は、問題終了キーワードを使用します。 ユーザーが 1 か所で作業を追跡できるように、 Projects にリンクすることもできます。

### 状態をラベルで強調表示する

状態ラベルは、レビュー担当者が pull request がレビューの準備ができているか、ブロックされているか、進行中であるかを理解するのに役立ちます。 ラベルをクリアすると、ユーザーはレビューに優先順位を付け、準備が整う前に作業のレビューを回避しやすくなります。

## 詳細については、次を参照してください。

* [レビューの解決](/ja/enterprise-cloud@latest/pull-requests/concepts/resolving-reviews)
* [プルリクエストを課題にリンクする](/ja/enterprise-cloud@latest/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue)
* [ラベルを管理する](/ja/enterprise-cloud@latest/issues/using-labels-and-milestones-to-track-work/managing-labels)