identify-reviewer

レビュアーの特定

差分、コミットログ、以前のコメントを分析する前に、あらゆるコードレビューのワークフローの開始時にこのスキルを読み込んでください。

---

手順

1. ユーザーを特定します。 次のコマンドを並列で実行します。

   gh auth status
   git config user.name
   git config user.email
   

   • gh auth status から Logged in to github.com account <USERNAME> を解析し、GitHub のハンドルを取得します。
   • git config から、ローカルユーザーのコミット時の名前とメールアドレスを取得します。

   これらは完全には一致しない場合があります（例：GitHub のハンドルが octocat、git の名前が Octo Cat、git のメールアドレスが [email protected]）。いずれも同じ人物を示します。

   gh がインストールされていない場合、またはユーザーが認証されていない場合は、git config のみを使用します。どちらも利用できない場合は、ユーザーの特定をスキップしてそのまま続行してください。レビューを妨げないでください。

2. セッション中はユーザーの識別情報を保持します。 見つかった識別情報を次のように使用します。

   • 以前のレビューコメントの作成者を特定する。 ユーザーが以前に PR にコメントしている場合は、そのコメントに言及するときに三人称（「octocat が X を指摘しました」）ではなく二人称（「X についての以前のあなたのコメント」）を使います。
   • コミットの作成者を特定する。 git log の出力を分析するときは、作成者名とメールアドレスを git config の値と照合します。ユーザー自身のコミットには二人称（「あなたのコミット abc1234 が…を導入しました」）を使い、ほかの作成者のコミットには三人称を使います。
   • 承認状況を確認する。 ユーザーがすでに承認しているか、変更を要求しているか、まだレビューしていないかを確認します。それに応じてレビューの概要をまとめます（例：「あなたは以前この PR を承認しました。承認後に見つかった内容は次のとおりです」）。
   • 役割を区別する。 ユーザーが PR の作成者でもある場合は、そのことを明確に示し、トーンを調整します（セルフレビュー）。PR のメタデータではどちらか一方が使われる場合があるため、GitHub のハンドルと git の作成者メールアドレスの両方で照合します。

3. レビュー全体を通じて適用します。 ユーザーの以前のコメントまたはコミットに言及する指摘では、すべて二人称を使います。ほかの人の以前のコメントやコミットには、引き続き三人称で、その人のハンドルまたは名前を使います。

照合ルール

• gh auth status から取得した GitHub のハンドルは、PR のレビューコメントの作成者および PR の作成者のログイン名と照合します。
• git config user.name の git 名は、git log --format='%an' の作成者名と照合します。
• git config user.email の git メールアドレスは、git log --format='%ae' の作成者メールアドレスと照合します。
• 次の識別子のいずれかが一致すれば、その人物をローカルユーザーとみなします。

例

このスキルを使わない場合：

octocat は以前のレビューでパフォーマンスの低下を指摘しました。作成者は異議を唱えました。

このスキルを使う場合（ローカルユーザーが octocat の場合）：

あなたは以前のレビューでパフォーマンスの低下を指摘しました。作成者は異議を唱えましたが、ベンチマークは提示しませんでした。

このスキルを使わない場合：

Octo Cat によるコミット abc1234 は、デコーダーのインターフェースをリファクタリングしました。

このスキルを使う場合（git の user.name が「Octo Cat」の場合）：

あなたのコミット abc1234 は、デコーダーのインターフェースをリファクタリングしました。