SuperAPI AI 工具集

triage-review

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:消费 PR 上已有的评审评论(Copilot 机器人与人工评审者),判断哪些值得修复、哪些不值得。它不做全新评审,而是对已有评论做判断,每条评论都先对照当前代码核实再下结论。全程只读,不回复线程、不解决会话、不发布任何内容,输出是给用户的决策辅助。与 /code-review、/review 的区别在于:后两者生成新发现,本技能评估已有评论。

主要能力与流程:

  1. 用 gh 抓取评论,默认当前分支的 PR,覆盖行内线程评论与顶层评审摘要,来源含 Copilot 与人工评审者。只保留未解决线程——解决状态在 GraphQL 的 reviewThreads 字段(isResolved),不在 REST 的 pulls/comments 中,因此过滤已解决或过时噪音时需用 gh api graphql。记录作者、路径、行号与正文。若无未解决评论,报告后停止。
  2. 逐条对照当前代码核实:读取 path:line 处文件,确认评论是否仍适用。评审者(尤其机器人)常针对过时 diff 评论并忽略上下文;outdated: true 的线程默认倾向 Skip,除非该问题在当前代码中仍成立。
  3. 按评分标准分类,每条结论附一行基于代码证据的理由。
  4. 输出分诊表,按 Address 优先分组。
  5. 询问是否修复 Address 项;同意后交给 /tdd(测试先行)。不自动实现,不处理 Skip/Optional/Discuss 项。

分类标准:Address 为经当前代码核实确属真实缺陷、风险、正确性缺口或明显有效改进;Skip 为错误、误报、已过时、违背既有代码约定或超出本 PR 范围,理由须引用证据;Optional 为主观风格偏好、无正确性影响,由用户决定;Discuss 为需要用户才能决策的有效顾虑(产品权衡、破坏性变更、架构方向)。

输出格式:标题为 Triage: PR #<n> — <title>(<count> unresolved),下分 Address、Optional、Discuss、Skip 四节,每条含 path:line、@author、评论要点与理由。

错误处理:gh pr view 失败时运行 gh auth status;若不在 PR 分支则询问 PR 编号。被评论文件在 PR 中被删除或重命名时,注明并倾向 Skip。Copilot 评论引用 diff 之外的行时视为低信号,先核实周边代码。

限制:只读,不修改代码、不回复评论;判断依赖当前代码与 gh/GraphQL 可用性;不自动实现修复。具体安装方式与收费信息暂未提供。