weigh-comments 是一个面向代码评审场景的技能,用于帮助用户处理队友在 Pull Request 中留下的评审评论。它的核心思路是:让代码本身来检验评论中的主张,由用户决定如何回复。技能不会自动发布任何内容,只有用户明确指示发布时才会发布。
用途 当用户想了解某条评审评论是否成立、需要整理对评论的看法,或准备回复队友评论时,可以使用该技能。它适用于日常 PR 评审沟通,尤其是评论较多、需要快速判断哪些需要修改、哪些可以礼貌反驳的场景。
主要能力
- 收集评论:从请求中获取 PR,否则使用当前分支的 PR。通过 gh api graphql 拉取评审线程、评论和评审记录,包含是否已解决、是否过时、文件路径、行号、作者、正文、时间和 URL。
- 过滤与筛选:丢弃机器人评论(如 CodeRabbit、Greptile、Macroscope、[bot] 登录名)。当用户指定某人时保留其评论;否则保留未解决的评论以及比最新推送更新的评论。
- 判定:针对每条评论,在 PR 头部代码上核实其主张——打开文件、跟踪调用、尽可能运行所述用例。判定分为:正确(问题真实,说明什么会坏、影响谁)、部分正确(指出成立与不成立的部分)、错误(展示回答该问题的代码或输出)、品味(无正确性利害,给出倾向和理由)。无法确认的主张会明确说明。
- 报告与起草:在对话中逐条给出作者、一行引用、判定、证据和建议动作(在本 PR 修复、跟进工单或不修改),并用用户口吻起草简短回复,结论先行;对“错误”判定要友善解释并引用代码。然后停下来等待用户。
- 按用户指示行动:修复则修改代码、推送,仅在用户要求时在评论线程回复;跟进则创建工单并加入 PR 描述的跟进列表;发布则仅发布用户批准并编辑后的回复。
使用方式 该技能通过对话触发,用户提出对某条评论的看法或请求处理 PR 评论时启用。它依赖 gh 命令行工具和 GitHub GraphQL API 获取数据。用户需要明确指示是否修复、跟进或发布回复。
适用场景 适用于团队协作中的 PR 评审环节,帮助开发者快速判断评论有效性、准备回复、决定修复或跟进。
限制 技能本身不自动发布内容;需要 GitHub 访问权限和 gh 工具;评论过滤规则基于内置的机器人列表;无法确认的主张会标注为未确认;具体修复和工单创建需用户明确指示。资料未提供更多关于安装、收费或平台支持的细节。