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，请用第二人称提及这些评论（“你先前关于 X 的评论”），而不是第三人称（“octocat 指出了 X”）。
   • 归属提交。 分析 git log 输出时，将作者名称／电子邮件与 git config 中的值进行匹配。用第二人称提及用户自己的提交（“你的提交 abc1234 引入了……”），其他作者的提交则用第三人称。
   • 筛选审批状态。 注意用户是否已经批准、请求更改或尚未审查。相应地组织审查摘要（例如：“你之前已批准此 PR；以下是你批准后发现的新问题”）。
   • 区分角色。 如果用户同时也是 PR 作者，请明确指出并调整语气（自我审查）。通过 GitHub 用户名和 Git 作者电子邮件进行匹配，因为 PR 元数据中可能出现其中任意一项。

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 重构了解码器接口。