SuperAPI AI 工具集

oh-review

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:对指定 PR 进行代码审查,先核对它关联的 issue 需求,再以 GitHub review 形式发布结构化反馈。除发布审查评论外保持只读,不修改代码、不提交。

主要能力:读取 PR 元数据与 diff;解析 PR 正文中的 Closes #N、Fixes #N、Resolves #N 找到关联 issue,并以 issue 作为需求依据提取验收标准、目标、上下文与约束;在无关联 issue 时仅审查代码质量并注明无法验证需求。审查覆盖需求是否满足、代码质量(缺陷、错误处理、边界情况)、与仓库既有模式的一致性、测试与文档缺失。输出分节:需求核对、Blocker(P0-P1)、改进项(P2-P3)、Clean、后续工作。依据是否发现阻塞项,使用 gh pr review 选择 --request-changes 或 --approve 发布。

用法:在存在该 PR 的仓库根目录运行 /oh-review <pr-number>,其中 <pr-number> 为要审查的 PR 编号。前置条件:需已认证的 GitHub CLI(gh);可选读取 .wm/dive_context.md 获取项目背景。流程中使用的命令包括 gh pr view <pr-number> --json title,body,headRefName,baseRefName,additions,deletions,changedFiles,state,mergeable、gh issue view <N> --json title,body、gh pr diff <pr-number>,并将结构化审查写入临时文件后用 gh pr review 发布。若 PR 非 open 状态则中止。

结束与信号:完成时必须调用 signal_completion 作为最后动作。已批准用 status: "success",已请求修改用 status: "blocked",不可恢复失败用 status: "error";若工具不可用,则以 COMPLETION: status=... message=... 或 error=... 格式输出。

适用场景:需要按 issue 需求而非孤立代码来审查 PR 的团队。限制:除审查评论外不做代码改动;不自动创建后续 issue,只作为评论提出由人决定;依赖 gh 认证与具体 PR/issue 数据。其余安装方式、收费与平台信息暂未提供。