SuperAPI AI 工具集

update-pr-review

编程与开发

查看项目

更新于 11-18 20:04

技能介绍

用途:该技能是一个自我改进循环,用于从真实审查者反馈中改进仓库本地的两个配套审查技能:.agents/skills/review-pr-local/SKILL.md 和 .agents/skills/review-spec-local/SKILL.md。仓库使用两个独立审查技能:review-pr 用于代码拉取请求,review-spec 用于仅规格拉取请求(所有变更文件都位于 specs/ 下)。两类 PR 的反馈应分别路由到对应的本地配套技能。

写入范围:该循环只允许写入 .agents/skills/review-pr-local/(及其中的 SKILL.md)和 .agents/skills/review-spec-local/(及其中的 SKILL.md)。不得触碰共享的 review-pr 技能、.agents/skills/review-spec/SKILL.md(核心契约)、.github/issue-triage/ 下的任何文件(该分类由 update-triage 循环负责)以及任何其他核心技能。自我改进运行器在推送前通过针对允许前缀的 git diff 检查来强制执行此限制,违规会中止运行。

输入:可选仓库覆盖(不在目标检出目录运行时使用);可选时间窗口覆盖(默认七天回溯);可选代理登录覆盖(审查评论不是由默认机器人身份撰写时使用)。

工作流:先验证 GitHub CLI 认证:gh auth status。然后使用捆绑脚本汇总最近一周更新的拉取请求反馈:python3 .agents/skills/update-pr-review/scripts/aggregate_review_feedback.py。默认针对当前仓库、回溯 7 天,分析由 PR 审查工作流使用的机器人身份(warp-dev-github-integration[bot])撰写的审查评论,同时收集这些 PR 中更广泛的人类审查评论,以便从审查者规范中学习。脚本将结构化 JSON 写入临时文件并打印路径;该文件应视为草稿状态,而非面向用户的交付物。如需其他仓库,传 --repo owner/name;如需不同作者身份,可多次传 --agent-login <login>。

输出中每个拉取请求包含 review_type 字段,值为 "spec"(所有变更文件位于 specs/ 下)或 "code"(变更了任何非规格文件)。据此将反馈路由到正确技能。阅读生成的 JSON,寻找重复出现的审查者信号,尤其是:回复称代理反馈错误、无效、不适用或基于错误假设;代理方向正确但严重程度、范围、行定位或建议修复有误;反馈不够可操作,包括要求更清晰的具体变更;人类因仓库或产品上下文变化而推翻机器人的反复情况;仅人类线程中体现的审查模式,显示该仓库有经验的审查者持续关注的内容;审查者关于什么应内联、什么应放在摘要中以及机器人何时应保持不确定的明确指导。

按 review_type 分区:"code" PR 的反馈适用于 .agents/skills/review-pr-local/SKILL.md;"spec" PR 的反馈适用于 .agents/skills/review-spec-local/SKILL.md。分别独立更新每个配套技能,采用能解释该类别反馈的最小规则变更。若某类别反馈为空,则跳过该配套技能。保持核心审查契约稳定——绝不编辑共享 review-pr 技能或 .agents/skills/review-spec/SKILL.md,只有 -local 配套技能会从反馈中演进。

证据规则:优先采用多个线程支持或维护者明确强陈述的模式;不因单次分歧而削弱正确性、安全性或数据丢失检查;将审查质量反馈与仓库特定偏好反馈分开;避免将一次性审查者偏好编码为通用规则;若反馈指向缺失的仓库上下文,仅在该上下文能提高审查精度时添加;不得将代码审查反馈混入规格技能,或将规格审查反馈混入代码技能。

中间状态:脚本构建结构化 JSON,捕获最近 PR 窗口的元数据(含 review_type 分类)、收到人类回复的代理撰写审查评论、同一 PR 中人类撰写的审查评论(即使并非回复机器人)、线程元数据(文件路径、行、解决状态、过时状态)、规范化代理评论字段(严重程度标签、是否包含建议块)、每个代理评论的完整人类回复集合、顶层 PR 问题评论以提供更广泛审查上下文。将这些临时数据作为改进技能的证据,若显式写入磁盘则在完成前删除。

最终检查:重新阅读更新后的 review-pr-local 和/或 review-spec-local 配套技能,确认新规则明确;保持每个配套技能简洁,不要变成冗长风格指南;在名为 oz-agent/update-pr-review 的本地分支上提交更改,不要推送分支——Python 入口点将运行写入范围守卫,仅在守卫通过时推送;若更新值得开 PR,将从推送的分支打开 PR,并在该 PR 上标记 @captainsafia 为审查者;依赖任何临时 JSON 前先用 jq 验证。