SuperAPI AI 工具集

pr-comment-analyzer

通用与其它

查看项目

更新于 10-16 03:36

技能介绍

用途:分析拉取请求(PR)上的所有评审评论,评估其相关性、识别歧义与可能过时的反馈,并生成详细报告与建议的 Q&A 讨论,不修改任何代码。与 PR resolver 不同,本技能只分析、报告和生成讨论,不提交、不解决线程。

主要能力:抓取 PR 元数据与全部评审线程(GraphQL 分页,每页最多 100 条);对每条评论提取元数据(线程 ID、文件路径与行号、作者、时间、解决/过时状态、正文、diffHunk);评估相关性(高度相关、可能相关、过时、不清晰、已解决);分类评论类型(缺陷修复、功能请求、代码质量、文档、性能、测试、架构、问题讨论、建议/小意见);评估意图清晰度(明确、隐含、歧义、不清晰);检查矛盾评论;分析过时状态;识别歧义类别并给出严重程度评分;生成 Markdown 报告与 Q&A 讨论提示。

使用方式:需先安装并认证 gh CLI,执行 gh auth status 验证,未认证则运行 gh auth login,令牌需 repo 权限。用 gh pr view 获取 PR 信息,用 gh api graphql 查询 reviewThreads 并循环分页直到 hasNextPage 为 false,收集全部线程后再分析。报告可保存为 pr-<PR_NUMBER>-analysis.md 并输出到标准输出。

适用场景:需要先理解评审反馈全貌再决定如何修改时;识别需要澄清的模糊反馈;梳理 PR 评审状态与评论分布;对过时评论判断是否仍适用;以 Q&A 形式推动讨论。

限制:只读分析,不修改文件、不提交、不解决线程;必须始终从 GitHub 获取最新数据,不能复用旧上下文;需 gh CLI 认证与 repo 权限;API 分页需完整抓取,遗漏线程会影响结论;评论相关性、歧义与过时判断依赖分析过程,可能需人工复核。