用途
vs-fix-pr 用于处理 PR 评审者留下的反馈。当开发者在自己的 PR 上收到评论时,该技能负责逐条跟进行内讨论线程:在同一线程内回复,并在用户批准后将其标记为已解决。
主要能力
定位 PR 与确认分支
首先判断用户是否在对话中给出了 PR 编号或 URL,若有则据此解析 PR 编号与源分支(headRefName);若没有则使用当前分支对应的 PR。若 gh pr view 失败(找不到 PR),会提示“No PR found”并停止。随后读取当前分支,若与 PR 分支不一致:存在未提交改动时,向用户列出文件并给出三个选项——stash 后切换(git stash --include-untracked)、不 stash 直接切换、取消;工作区干净时则询问是否切换,选择切换则执行 git checkout 与 git pull。
检查构建状态
通过提交状态 API 与 gh pr checks 获取构建状态:success 继续;pending 时告知用户构建仍在运行并询问是继续处理评论还是等待;无状态时继续;failure 时进入失败分析。失败分析会查看 CI 机器人评论的输出,识别测试失败、类型错误、lint 错误或构建错误,并通过 PR 文件列表判断错误位置是否在本次 PR 的 diff 中:若在则视为本次改动导致并读取失败文件、修复后以 fix: [描述] 提交;若不在则视为可能的外部或偶发问题,向用户提供选项(以 PR 评论说明、重新触发构建、跳过并继续处理评论)。
拉取评论并建立 TODO
分别拉取常规 PR 评论与行内代码审查评论(含 id、正文、作者、path、line)。若无评论则提示“No PR comments to address.”。之后为每条评论建立一个 TODO,行内评论会标注文件与行号。
逐条评估与处理
对每条评论评估其是否为有效反馈、是否提升正确性或质量、是否基于对代码的准确理解。高置信度(认同)时直接实现修复;低置信度(不认同或不确定)时先说明顾虑并询问用户,选项包括“跳过并回复原因”或“照常实现”。随后展示原评论、草稿回复与简要理由,并询问发布后是否解析该审查线程,选项为“回复并解析”“仅回复”“先编辑回复”。只有在获得批准后才发布回复:行内评论使用 replies API,常规评论使用 gh pr comment --reply-to。解析线程仅针对行内审查评论,且需经批准,通过 GraphQL 查询 reviewThreads 找到包含该评论的未解析线程并调用 resolveReviewThread;若找不到线程 ID,则告知用户回复已发布、可在 PR 界面中手动解析。完成后标记 TODO 并处理下一条。
使用方式
该技能以命令与 gh CLI、git、jq、GraphQL 查询配合执行,整体按 Step 0 至 Step 4 的顺序推进:确定 PR 与分支、检查构建、拉取评论、建立 TODO、逐条评估回复。
关键规则
- 未经明确批准绝不发布或解析,必须先展示草稿并等待确认。
- 始终回复到具体评论,使用 replies API,而非新建顶层评论。
- 处理行内审查评论时不要发布常规 PR 评论,保持在线程内。
- 默认行为:在用户批准后对行内线程执行“回复 + 解析”(除非用户选择不做)。
适用场景
适用于开发者已提交 PR 且评审者留下评论后的跟进阶段。其工作流中,上一步为 /vs-ship-it(PR 已创建、评审者留下评论),下一步为 /vs-ship-it(修复后重新推送)、/vs-roast-my-code(重新推送前自我审查)或结束。
结果提示
- 无评论:“No PR comments to address.”
- 全部处理:“All done! Addressed X comments.”
- 部分跳过:“Addressed X comments, skipped Y. Let me know if you want to revisit.”
限制
该技能的运行依赖 gh CLI、git 与 jq 等环境,并需要可访问对应的代码托管平台仓库;若找不到 PR 则直接停止。所有评论发布与线程解析均需用户批准。关于收费、价格、平台支持范围、效果等其他信息,资料中暂未提供。