SuperAPI AI 工具集

pr-address-feedback

编程与开发

查看项目

更新于 10-23 08:41

技能介绍

用途

pr-address-feedback 是一个用于处理 Pull Request(PR)评审意见的技能。它帮助你把 PR 上的评审评论逐条梳理清楚,对每条反馈做出决定:要么采取行动修改代码,要么回复说明理由,最后汇总成一份可审批的解决计划。

主要能力

  • 收集反馈:解析目标 PR(可用编号、URL 或 owner/repo#N 指定,否则使用当前分支的 PR),通过 GraphQL 分页获取所有评审讨论串,包括 id、是否已解决、是否过时、文件路径、行号、diff 侧以及每条评论的 databaseId、URL、作者、正文、diffHunk、创建时间等。同时获取顶层评审正文和 PR 会话评论。
  • 过滤与排序:跳过已解决的讨论串,以及作者已最后发言且看起来已处理的讨论串;对过时讨论串会提示但仍检查反馈是否适用于当前代码。排序时先识别依赖和模式,把设定模式的评论放在最前,引用它的评论紧随其后,其余按文件和行号排列。
  • 逐条呈现:在可见消息中先告知条目总数并给出索引,然后按顺序一次呈现一条。每条使用固定模板,包含反馈原文、diff 上下文、当前代码、证据与相关上下文、评估、建议(行动或回复),并附上评论 URL。
  • 决策交互:通过 ask_user 获取你的决定,选项包括按建议行动、回复说明理由、以不同方式行动、跳过/推迟等。
  • 生成解决计划:所有条目决定后,写出单一计划,列出每条评论链接、决定、代码改动、要发布的回复文本以及是否解决讨论串,最后列出需要重新请求评审的评审者。
  • 执行已批准计划:在编辑前确保工作树是 PR head 的干净检出,做小而聚焦的提交,先推送再回复,确认提交可从 headRefOid 到达后再发布回复,按默认规则解决讨论串,最后重新请求评审。

使用方式

该技能以计划模式运行。你提供 PR 目标(编号、URL 或 owner/repo#N),技能会收集并整理反馈,逐条与你确认处理方式,最终生成计划供你审批。审批通过后才执行代码修改、提交、推送、回复和解决讨论串等操作。

适用场景

  • 需要系统性地处理 PR 上大量评审意见时。
  • 希望区分哪些反馈应修改代码、哪些应回复说明理由时。
  • 需要生成结构化解决计划并跟踪每条反馈处理状态时。

限制

  • 在计划获批前不执行任何写操作,仅允许只读命令。
  • 需要访问 GitHub(github.com 或 GitHub Enterprise Server),并正确设置 hostname。
  • 部分工具(如 reply_and_resolve_review_thread)仅在部分 Copilot 界面提供,否则需通过 gh api 和 GraphQL 完成。
  • 具体收费、价格、平台支持范围等资料暂未提供。