SuperAPI AI 工具集

review-implement-phase

编程与开发

查看项目

更新于 10-16 06:37

技能介绍

用途

review-implement-phase 是 review-framework 循环中专门负责“实现阶段”的技能。它只运行该循环的实现部分:接收已经分诊确认要处理的 review 动作(triaged will_address actions),据此进行代码修改、创建聚焦提交、发布 GitHub 状态更新,并更新动作状态。

主要能力

  • 读取并选择可执行的动作行:decision 为 will_address,status 为 pending 或 in_progress。
  • 在开始实现前预检 GitHub 管理能力(check-github-admin-ready.mjs),不可用则快速失败。
  • 通过 agents/review-implementer.md 委托实现工作:进行代码修改、运行相关检查、创建聚焦提交、在开始每个动作时发布 “On it”、完成时发布 “Done”。
  • 仅在目标为 review_thread 且存在 threadNodeId 时解决讨论线程;对于 pull_request_review 目标(review-body findings、PRR_… 节点 id)则跳过解决步骤,改为发布顶层 PR issue comment,并记录 issue-comment id。
  • 使用封装的辅助脚本进行线程管理操作:post-review-thread-reply.mjs、resolve-review-thread.mjs。
  • 渲染最新的动作 markdown:通过 render-review-actions.mjs 将 review-actions.json 转为 review-actions.md。
  • 更新 review-actions.json 中的 status、done.doneAt、done.summary、done.commits。

使用方式

必需输入:PR URL、输出目录中已存在的 review-actions.json。

可选输入:输出目录、范围约束(特定 action ID 或文件)。

若省略输出目录,默认推导为:wip/reviews/<owner>_<repo>_pr-<number>/。

前置条件:

  • <output-dir>/review-actions.json 必须存在且为有效的 v2。
  • PATH 中需要 gh(GitHub CLI);若缺失则立即停止并要求用户安装。
  • 启动实现前必须具备 GitHub 管理能力,通过 node ./scripts/check-github-admin-ready.mjs --pr <PR_URL> 检查。
  • 若缺少该能力,需指示用户先运行 /review-fetch-phase 和 /review-triage-phase。

评论发布规则:

  • 始终发布独立评论(standalone comments),绝不使用 pending PR reviews。
  • 禁止的流程:gh pr review --comment ...;GraphQL addPullRequestReview、addPullRequestReviewComment、addPullRequestReviewThread。
  • 允许的流程:通过 addPullRequestReviewThreadReply(或封装脚本)回复线程;通过 addComment(或封装脚本)发布 issue 评论。
  • 对 review_thread 目标必须使用线程回复,而非内联 PR review 评论。若只有 thread node id,需先获取该线程主评论 node id,再调用 addPullRequestReviewThreadReply。

管理操作命令示例:

  • node ./scripts/post-review-thread-reply.mjs --repo <owner>/<repo> --pr <number> --comment-node-id <primaryCommentNodeId> --body "<text>"
  • node ./scripts/resolve-review-thread.mjs --thread-node-id <threadNodeId>(仅用于 review_thread 目标)

适用场景

当用户只希望执行 review-framework 循环的实现阶段时使用。它适合处理已完成分诊、明确要处理(will_address)的 review 动作,将修复落地为提交并回写到 GitHub 讨论中。

限制与阻塞条件

  • 如果无法执行 GitHub 线程的回复或解决,该阶段视为阻塞,不得报告完成。
  • 如果评论被意外作为 pending review 发布,该阶段阻塞,直到该 pending review 被显式提交或关闭,且动作评论被重新作为独立评论发布。
  • 每次动作完成后(Done 及适用时的 resolve),需检查是否有由该执行用户新建的 pending review;若有则工作流被阻塞,直到清理完毕。
  • 在开始实现前需检测该 PR 上由当前执行用户创作的 pending reviews;若存在则停止并清理(提交或关闭)后再继续。
  • 禁止使用内联解析片段(如 python -c、node -e、ruby -e、临时 awk/sed JSON 解析)。
  • 仅在 Done(且对 review_thread 目标而言 resolve)成功后才设置 status: done,并在同一步骤更新 review-actions.json。

输出

返回:创建的提交、已转为 done 的动作、写入的产物(review-actions.json、review-actions.md)。

建议的后续步骤:/review-fetch-phase <PR_URL> [output-dir]、/review-triage-phase <PR_URL> [output-dir]。

其他信息

该技能所属来源为 prisma/prisma-next。关于具体的收费、价格或更多平台细节,资料暂未提供。