gh-address-comments

name	gh-address-comments
description	Use when addressing GitHub PR review comments or issue comments on the current branch with gh CLI, including auth checks, comment triage, edits, verification, and replies.
zh_description	用于通过 gh CLI 处理当前分支的 GitHub PR Review 评论或 Issue 评论。
version	1.0.0
author	seaworld008
source	in-house
source_url
tags	["address", "automation", "comments", "workflow"]
created_at	2026-03-04
updated_at	2026-06-29
quality	2
complexity	intermediate
metadata	null
short-description	Address comments in a GitHub PR review

PR Comment Handler (GitHub CLI)

用于快速定位当前分支对应的 GitHub Pull Request 并自动处理其中的 Review 意见或 Issue 评论。该技能通过 gh CLI 工具与 GitHub API 交互，能够读取评论、理解意图、提出修复建议并自动执行代码修改，从而显著加快代码评审的闭环速度。

安装与配置

# 确保已安装 GitHub CLI
brew install gh
# 登录并授权相关权限 (repo, read:org, workflow)
gh auth login

触发条件 / When to Use

• PR 进入反馈阶段：在 CI/CD 完成后，评审人提出了若干修改建议。
• 批量处理琐碎反馈：如拼写错误、变量重命名、代码风格调整等无需深度逻辑讨论的评论。
• 远程协作同步：当多个团队成员在同一个 PR 下进行异步讨论，需要快速汇总并执行共识。
• 遗留 PR 清理：针对已经开启多日但未合入的 PR，自动检索所有未解决（Unresolved）的对话。
• 自动化测试失败复盘：如果评审人指出了测试用例的覆盖不足，Agent 自动根据评论补充测试代码。

核心能力 / Core Capabilities

1. 评论提取与语义分类 (Observation)

• 操作步骤：
  1. 验证当前分支：git branch --show-current。
  2. 获取 PR 编号：gh pr view --json number,url。
  3. 读取所有 Review 线程：gh pr view --json reviews 或运行自定义脚本 fetch_comments.py。
• 最佳实践：优先区分 General Comment (全局评论) 和 Inline Comment (代码行内评论)，以便精准定位代码行。

2. 交互式任务确认 (Clarification)

• 操作步骤：
  1. 对所有评论进行编号。
  2. 针对每一条评论，评估修复难度和可能的变更方案。
  3. 输出清晰的列表：[编号] 评论内容 -> 拟修复逻辑。
  4. 使用 question 工具等待用户确认：“请问需要处理哪些编号的评论？”
• 最佳实践：对于不确定的评论，主动询问其语境，避免误改。

3. 自动代码修复 (Action)

• 操作步骤：
  1. 根据 path 和 line 信息，使用 read 工具定位本地源文件。
  2. 利用 LLM 生成修复后的代码块。
  3. 使用 edit 或 apply_patch 进行局部替换。
• 最佳实践：在修改后立即运行本地单元测试 npm test 或 pytest 以验证正确性。

4. 状态闭环 (Response)

• 操作步骤：
  1. 提交修复代码：git commit -m "docs/refactor: address PR review comments"。
  2. 推送代码：git push origin HEAD。
  3. 自动回复评论并标记为 ：。