用途:读取 self-review 生成的 XML 评审反馈文件,把其中的评审意见当作有组织的任务来执行代码修改。
主要能力:解析 self-review v3 XML;区分行级评论(new-line-start/new-line-end 或 old-line-start/old-line-end,二者互斥,均无则为文件级评论);识别 viewed、change-type(added/modified/deleted/renamed)、severity(critical>major>minor>info)、confidence(high>medium>low)等属性;处理评论线程(comment 为根,reply 为后续轮次,按文档顺序,无作者属性的 reply 视为人类评审者且覆盖此前机器断言);支持附件图片作为视觉上下文;支持 suggestion 的 original-code 到 proposed-code 替换。
使用方式:从 $ARGUMENTS 或默认 ./review.xml 读取文件,文件不存在则停止。用 xmllint --schema assets/self-review-v3.xsd <review-xml-path> --noout 校验,失败则停止并报告错误,未安装 xmllint 则警告后继续。根据根元素属性加载上下文:Git 模式运行 git diff <git-diff-args>;目录模式从 source-path 读取文件;远程模式通过 git fetch 或 blobless clone 重建 diff,并用 git diff <remote-base-sha>...<remote-head-sha> 与 git show <remote-head-sha>:<path> 读取内容。默认应用所有评论;仅当传入 --min-severity 或 --min-confidence 时启用阈值,未通过者搁置并在总结中列出。执行时跳过无评论文件,按文件创建任务,3 个以上有评论文件可并发子代理;suggestion 按行号降序自底向上应用,以文本匹配处理漂移。最后输出变更、问答和搁置评论总结。
适用场景:对 self-review 产出的结构化评审反馈进行自动化落地,尤其适合人工已筛选过的评审,或通过阈值控制的无值守运行。
限制:依赖 self-review v3 XML 格式与配套 XSD;远程模式若实时 head 与 remote-head-sha 不一致,行锚点可能失效,需按文本匹配;缺少 severity 或 confidence 的评论在阈值下视为低于所有级别;未提供安装方式、收费、平台等其它信息。