SuperAPI AI 工具集

improve-review-pr

编程与开发

查看项目

更新于 11-05 03:01

技能介绍

用途

improve-review-pr 用于按月对 /review-pr 代码评审技能做一次改进迭代。每一轮读取 /review-pr 实际运行过的评审结果,以及外部付费评审工具自上次以来公开发布的内容,提出至多两处修改,在门禁用例上验证每处修改,并把带数字的 diff 交给负责人提交。无改动被视为一次完整且良好的结果;没有数字支撑的修改只是个人品味。

数据位置

评审数据目录为 ${XDG_DATA_HOME:-$HOME/.local/share}/review-pr/,始终排除在任何仓库之外,因为其中引用了私有代码。该目录下:rounds/<owner>-<repo>/<target>/round-<n>/ 保存单轮评审(round.json、args.json、result.json、report.md,由 /review-pr 写入);gate/<case>/ 保存冻结评审用例(case.md、goldens.md、spec/、runs/<date>-<label>/);improve.md 是按时间追加的改进记录日志。仓库内 research/ 存放每个外部系统的带日期论文,docs/review-pr-speed.md 记录该技能形态背后的原因,timeline.py 与本文件同目录。

主要步骤

  1. 找到上次改进:读取 improve.md 最后一条记录,后续只读比其日期更新的内容。
  2. 读取评审轮次:对每轮从 round.json 取分钟数与得分、从 result.json 取计数;若该轮 transcripts 目录仍存在,运行 python3 timeline.py <会话的 .jsonl> 获取各 agent 耗时。需按仓库整理出表格(target、round、minutes、score、confirmed、uncertain、killed、deferred),并分别带数字指出:等待最久的阶段或 agent、每分钟回报最低的维度、后续轮次发现被破坏的任务、调查 agent 淘汰的候选、所有 not_reviewed 的 agent、达到 dry 所需轮次最多的目标。
  3. 读取外部信息:research/ 中每篇论文各派一个后台 agent 仅联网,抓取该论文日期之后该系统公开发布的内容(changelog、工程博客、文档),追加 ## Since <date> 小节,记录变化、简短引用、URL,以及是否涉及 docs/review-pr-speed.md 中未决问题;只使用一方来源;无新内容则写一行带日期的说明。
  4. 提出修改:至多两处,每处标明对应第 2 步的数字或第 3 步的来源,以及预期改善的数字;优先考虑删除类修改。
  5. 单独门禁验证每处修改:编辑技能后,逐一运行 gate/ 中所有用例。当 goldens.md 中“Must be confirmed”下的每个发现都再次被确认,且分钟数没有无理由上升时保留修改,否则回退;无论成败都将运行结果加入该用例 goldens.md 的表格,失败的修改也是结果。
  6. 扩充门禁:rounds/ 中在确认阻塞或重大问题后达到 dry 的目标可作为新用例,其 round-1 的 head 与 base 写入 case.md,spec 写入 spec/,确认的发现写入 goldens.md。单个 PR 作为门禁较弱,只能发现崩溃,难以反映召回率的少量变化。
  7. 汇报与记录:告知负责人读了什么、改了什么、前后数字对比,diff 保持未提交;决策变化时更新 docs/review-pr-speed.md;把本轮改进追加到 improve.md。

运行门禁用例

门禁运行是对冻结提交的一次真实评审,按流水线启动方式在分支上启动,不发布任何内容,成本与一次真实评审相当。在 case.md 中的仓库路径下执行 claude 命令(使用 --bg、--name “gate <case> <label>”、--worktree、--model opus --effort medium,并通过 --add-dir 加入技能目录、spec 与 runs 目录),传入按 case.md 填充的提示词:要求使用本仓库 skills/in-progress/review-pr 的技能,先读取其 SKILL.md 并遵循,以该目录为技能基础目录;这是分支评审而非 PR,先执行 git checkout --detach <head>,范围为 git diff <base>,不向 GitHub 发布、不运行 gh 命令;spec 路径为 <data>/gate/<case>/spec/<file>,关闭的问题在其旁边;不读 <data> 下其他内容;结束后把报告写入 <data>/gate/<case>/runs/<date>-<label>/report.md,把工作流原始结果写入同目录 result.json。后续轮次用例将首句换成“运行后续轮次,fix-verify”,并指定 case.md 中的任务列表与修复 diff。用一条后台命令等待 report.md 出现,然后在旁边写时间线:python3 timeline.py ~/.claude/projects/<worktree 项目目录>/<session>.jsonl > <run 目录>/timeline.txt。比较时应按发现的内容而非 id(每次运行 id 都会变)。最后用 claude rm <session id> 并执行 git branch -d worktree-gate-<case>-<label> 清理。

注意事项

每个评审 agent 都能看到门禁提示词,Workflow 工具会把启动运行的请求转给各 agent,提示词中若点名 golden 就等于把答案交给所有评审者。能读到 goldens.md 或 baseline/ 的运行不算测试,只应向会话添加 spec/ 与 runs/,并在提示词中保留“不读其他内容”。单次运行只是一次抽样,次要问题与测试缺口的严重度判定会波动,应基于阻塞与重大问题以及分钟数判断修改。每次运行只改一处,同时改模型与 effort 无法判断是哪项导致次要问题变化。已安装的技能是旧技能,冻结提交自带当时提交的 review-pr,因此提示词指向本仓库中的副本。transcripts 会过期,Claude Code 会删除旧会话,因此各 agent 耗时仅对较近轮次存在,round.json 保留分钟数。

分类

该工具用于代码评审能力的持续改进与质量验证,归入“编程与开发”。