一、用途 pr-feedback 面向代码评审反馈处理场景:获取 PR 的评审反馈与行内评论,对反馈进行分类整理,并向用户展示可选的修复项,供用户确认后处理。当用户要求获取、阅读、处理或修复评审意见时可使用。
二、主要能力
- 自动确定 PR 编号:通过当前分支自动检测,命令为 gh pr view --json number -q .number;若检测失败(如分离 HEAD、无跟踪分支),则向用户询问 PR 编号或 URL。
- 一次性抓取全部反馈:使用随附脚本获取评审、行内评论和 issue 级评论:bash .agents/skills/pr-feedback/fetch-pr-feedback.sh <number> [--repo owner/repo]。省略编号时从当前分支自动检测;PR 不在当前目录所属仓库时使用 --repo。
- 脚本返回 JSON,包含三个数组:reviews(仅非空正文的顶层评审总结)、inline_comments(未解决线程评论,含 upvotes/downvotes 用户名数组、outdated 标记,以及每个线程首条评论的 diffHunk)、comments(issue 级评论)。
- 汇总与优先级排序:阅读全部反馈,按相关性分组,输出逐条一行的编号清单,影响最大的排前。
三、优先级判断规则
- PR 作者点赞:表示认同,建议修复。
- 作者回复认同(如 "good point"、"I'll fix"、"makes sense"):等同点赞,建议修复。
- 其他评审者点赞:表示社区认同该问题重要,倾向建议修复。
- 作者无任何表态:作为建议提出,不默认应修复。
- 作者回复反对或解释:作为背景呈现,标记为 "discussed — likely skip"。
- 过时评论:单独归组置于末尾,可能已被后续提交处理。
展示清单时,对建议修复项加注,便于用户快速选择“全部推荐项”或逐项挑选。
四、使用方式与约束
- 修复阶段仅处理用户确认的项;修复后逐项用一行简述改动。
- 在询问用户前应先自动检测 PR 编号。
- 在展示清单并获得用户确认前,不得修复任何内容。
- 若输出过大无法一次解析,优先关注非过时评论。
五、适用场景 适用于需要集中阅读、筛选并落实 PR 评审意见的日常代码协作流程,尤其适合评论较多、需要区分优先级与过时反馈的情形。
六、限制 依赖 gh 命令行工具与所在仓库的 PR 环境;自动检测在分离 HEAD 等情况下会失败,需用户提供编号或 URL。评论解决状态、点赞等信号依赖平台数据,无表态时不做修复判断。具体支持的平台范围、收费情况等暂未提供。