SuperAPI AI 工具集

pr-thread-resolver

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:将 GitHub PR 中未解决的评审线程转化为已提交、已验证、已解决的修复,原生使用 gh CLI 与 Claude Code 的编辑/验证循环,无需外部编排器。仅适用于托管在 GitHub 的 PR 评审线程;本地评审笔记、仅监视合并或 CI 状态、仅 CI 日志失败等场景应改用其他技能。

主要能力:默认闭环为自主执行 修复→提交→推送→解决。先用 gh pr view <pr> --json headRefOid -q .headRefOid 捕获 head SHA,并通过 gh api graphql 列出未解决线程的紧凑工作清单(线程 id、路径、行号、isResolved、isOutdated、正文、建议块)。对每条线程读取当前行并分诊:已修复或已过时(isOutdated 且代码不再匹配)则带原因跳过;否则排入最小修复。修复时应用最小正确编辑,建议块仅在精确匹配时原样套用,否则手写最小修复。验证先跑受影响区域的聚焦测试,再跑类型检查、lint、构建。提交使用语义分组的约定式提交,所有预期提交通过验证后推送分支,再重新抓取 head 与线程状态,仅解决有已提交、已推送、已验证修复支撑的线程,或当前 head 已修复的线程。重复轮询直到无待办线程或出现真实阻塞。

并行:当至少 3 条线程涉及互不相交的文件时,可按文件/簇派发只读修复子代理;子代理只修复、验证、报告,不提交、推送或解决,父进程统一串行化暂存、提交、推送和 resolveReviewThread 变更。

解决安全策略:只有映射到已提交、已推送、已验证修复的线程才可解决;head 意外漂移、验证失败、被跳过或不明确的线程绝不可解决。默认不自动回复,仅在线程无法干净修复或用户要求评论时回复。输出包括工作清单、验证修复/跳过摘要、验证命令与结果、提交 SHA、线程到提交的关闭映射以及终止状态。相关参考文档见 references/gh-graphql.md 与 references/closeout.md。