SuperAPI AI 工具集

cmd-pr-gh-comments

通用与其它

查看项目

更新于 10-16 02:37

技能介绍

用途:针对当前分支 Pull Request 的评审评论做整体分流与处理,先把所有评论及其定位信息拉全,再结合代码上下文形成统一计划,与开发者确认后执行,而不是逐条机械修改。

主要能力与流程:先检查环境,确认 gh 已认证(gh auth status)且不在默认分支(git branch --show-current)。随后用 gh pr view --json number,url,headRefName,baseRefName 识别 PR,并用 gh repo view --json nameWithOwner 获取仓库信息。

评论拉取:通过 GitHub API 分页获取三类内容——内联评审评论 repos/{owner}/{repo}/pulls/{pr_number}/comments、评审级评论 pulls/{pr_number}/reviews、普通会话评论 issues/{pr_number}/comments。对内联评论提取 id、node_id、作者、正文、path、start_line、line、side、diff_hunk 等,并归一化为 {file, start_line, end_line, side}。会过滤机器人评论和已解决线程,但保留当前用户自己的评论。

上下文与相邻改进:每条评论向两侧各扩约 30 行读取,捕捉所在函数/结构体及 TODO、FIXME、docstring、弃用标记等信号;用 rg 搜索重复模式、相关 TODO 和调用点,形成可选的相邻改进建议。

计划与执行:把评论分为 Fix、Investigate、Discuss、Acknowledge、Outdated,合并同源问题,相邻改进标为 [adjacent, opt-in],以清单形式呈现并等用户确认。执行时先做 Fix,再应用已接受的相邻改进,Investigate 与 Discuss 视情况重新分类或交由用户决定,最后输出变更汇总表。

其他步骤:经用户同意后通过 GraphQL 查询线程 ID 并 resolveReviewThread 解决评论线程;按需建议更新 AGENTS.md、cmd-olshanskify 的 templates/code.md 等,但必须获得明确确认后才写入。

限制:不会自动提交或推送,由用户手动提交;不会自动解决线程或修改配置文件;所有写操作均需用户确认。平台支持、计费与价格信息暂未提供。