gh-address-comments
作者 openaigh-address-comments 可帮助你使用 gh CLI 处理当前分支对应的 GitHub 开放 PR 上的审查和问题评论。它会先验证 GitHub 认证，然后抓取评论和 review 线程、为其编号，并帮助你选择需要修复的条目。适合需要 gh-address-comments 指南以及 gh-address-comments 用于 PR Review 工作流的场景。
该技能得分 78/100，说明它是一个相当合格的目录候选：用户可以围绕当前分支的开放 GitHub PR，清晰触发一个用于处理评论的工作流，而且具备足够的操作细节，能帮助判断何时安装以及它会做什么。它很适合由 agent 驱动的 PR 清理，但距离面向更广泛用户的成熟度还有一步之遥。
- 触发条件清晰：它面向当前分支的开放 PR，并明确要求先验证 `gh` 认证。
- 工作流具体：包含分步骤流程，以及用于抓取 PR 评论、review 和内联线程的辅助脚本（`scripts/fetch_comments.py`）。
- 安装决策价值高：描述和默认提示词都很直观地说明了用途——处理可执行的 GitHub PR 审查评论并汇总更新。
- 依赖 `gh` 认证和更高权限的网络访问，因此在受限环境中如果权限没有正确处理，可能会失败。
- 操作指导范围较窄：它覆盖了评论的检查和选择，但实际的修复应用流程大多仍然是隐含的。
gh-address-comments 技能概览
gh-address-comments 是做什么的
gh-address-comments 帮你查找并处理当前分支上已打开 GitHub PR 里的可执行评论，以上下文来源于 gh 和仓库里的 review threads 为准。它就是为这种场景设计的：一个 PR 的反馈散落在多个 review thread 里，你需要在改代码之前，先用结构化方式判断哪些问题要修。
这个技能适合谁
如果你已经有一个分支，并且对应的 GitHub PR 已打开，但你需要处理 review 或 issue 评论，又不想手动在 GitHub 里一条条翻找，那就适合用 gh-address-comments。它最适合维护者、贡献者，以及做 PR 清理的 agent，尤其是在主要问题是评论分拣，而不是大范围重构的时候。
它为什么不一样
这个技能不只是“读 PR 然后改文件”。它会先检查 GitHub 认证，再拉取评论和 review threads，给它们编号，汇总需要做的工作，然后再问你要处理哪些项。相比默认假设“每条评论都要修”的通用提示词，gh-address-comments 更适合做有选择性的 PR review 工作。
如何使用 gh-address-comments 技能
安装 gh-address-comments
先把 gh-address-comments 技能安装到你的 skills 环境里，然后确认你要处理的仓库已经在本地检出，并且和你要查看的 GitHub PR 关联起来。只有当你的环境支持来自 openai/skills 的 skills 时，gh-address-comments install 这一步才有意义；这个技能本身依赖 gh 可用且已经完成认证。
准备合适的输入
为了获得更好的 gh-address-comments usage 效果，最好从一个已经在 GitHub 上打开 PR 的分支开始。这个技能需要当前分支上下文，而且当你的请求把 PR 目标说清楚时效果最好，比如“处理这个分支上的 review comments”或者“整理 open PR 里的可执行评论”。
建议的工作流
- 先确认
gh auth status能正常工作，并且具备仓库和 workflow 访问所需的 scopes。 - 运行这个技能，拉取评论和 review threads。
- 查看编号列表和修复摘要。
- 选择先处理哪些项目。
- 应用修改，然后重新检查 PR 讨论里是否还有遗漏。
先读哪些文件
先看 SKILL.md，了解预期流程；再查看 scripts/fetch_comments.py，弄清评论是怎么收集的。还可以顺手看 agents/openai.yaml，了解默认 prompt 和工具封装方式。在这个仓库里，这三个文件能提供最有用的 gh-address-comments guide 上下文，而且不需要你把整棵目录树都读完。
gh-address-comments 技能 FAQ
gh-address-comments 在没有 gh auth 的情况下能用吗？
不能。gh-address-comments 预期先完成 gh auth login 的设置，工作流也会在查询 PR 之前显式验证认证状态。如果认证失败，或者 token 缺少必要的 scopes，技能应该提示重新认证，而不是自行猜测。
它比普通 prompt 更好吗？
如果任务和 PR 紧密相关，而且是由评论驱动的，那答案是肯定的。普通 prompt 可以描述怎么修 review，但 gh-address-comments for PR Review 多了一个可重复的输入步骤：拉取 threads、编号、总结影响，然后让用户自己决定先处理哪些。
什么时候不该用它？
如果当前分支没有打开的 PR，如果你需要从头重新设计功能，或者这些评论只是闲聊而不是可执行项，就不要用 gh-address-comments。如果你想一口气自动批量修改每条评论，而不是先审阅判断，它也不是合适的选择。
适合新手吗？
适合，前提是用户会处理 GitHub PR 和基本的 CLI 认证。这个技能把 review 噪音整理成一个有编号的决策列表，降低了认知负担，但它仍然默认你能够检查代码，并判断哪些评论值得处理。
如何改进 gh-address-comments 技能
给技能更明确的目标范围
gh-address-comments 想要效果好，关键在于先说明什么算可执行项。如果你只想处理样式修正、API 更正或逻辑修改，就一开始说清楚。这能帮助技能优先处理真正重要的评论，避免把时间花在可选建议上。
补充会改变修复方式的上下文
当某条 review comment 取决于产品行为、兼容性或测试约束时，在技能开始改动之前把这些上下文写进请求里。例如：“保持向后兼容”“不要改 public interface”“把修复限制在这个分支内”。这类信息对第一次处理的帮助，明显大于笼统的“注意一点”之类提示。
留意常见失败模式
gh-address-comments 里最常见的风险是 thread 过时、认证问题，以及过度修复——把本来应该讨论的评论直接改掉。若拉取出来的列表看起来不完整，或者这个分支的 PR 最近刚变过，编辑前先重新跑一遍 fetch 步骤。如果某条评论含义模糊，先澄清再打补丁。
在第一轮之后继续迭代
在应用完你选中的修复后，重新打开 PR thread 列表，把剩余评论和你刚做的改动对照起来。对于 gh-address-comments skill 这类工作流，最快的改进循环就是：拉取、选择、修复、复查，然后只针对仍然阻塞 approval 的评论继续细化。