用途:从 GitHub 拉取指定 PR,用多个专用代理并行审查,在本地修复问题,最后生成仓库根目录下自包含的 pr-review.html,便于合并前在浏览器中查看。\n\n主要流程:\n1) 确定要审查的 PR(用户给出的编号/URL/分支,或当前分支的 gh pr view --json number),并拉取元数据与 diff。若不在 PR 分支上,执行 gh pr checkout <pr>;工作区不干净会先停下询问,避免丢改动。先向用户确认要审查的 PR(编号、标题、作者、head→base、提交数)。\n2) 查找匹配的功能规格(按分支名与标题在 specs/ 下搜索),若有则读取需求、设计、任务与决策日志。\n3) 并行启动审查代理:代码复用(查找重复实现、可复用的工具)、代码质量(冗余状态、参数蔓延、复制粘贴、抽象泄漏、字符串类型)、效率(重复计算、N+1、串行可并行、TOCTOU、无界结构、监听器泄漏、整文件读取);若找到规格则加规格与文档代理。\n4) 汇总发现并在检出的 PR 分支上本地修复;默认不自动提交或推送。非测试确实有误不改测试文件。\n5) 验证:跑测试套件(可用 Makefile 命令)、linter 与校验器;测试失败视为修复引入的回归。\n6) 调用 explain-like 技能生成初级/中级/专家三级说明,并提取重要变更、可复用经验与决策依据(依据不足时列为开放问题,不臆造)。\n7) 用共享渲染脚本 ~/.claude/scripts/build_review_html.py 生成报告,先为每个文件写出 diff 片段,再组装 review.json,最后执行:python3 ~/.claude/scripts/build_review_html.py --data /path/to/review.json --output {repo-root}/pr-review.html --diff-dir /path/to/diff-fragments。不要手写 HTML。\n8) 若 pulsar 在 PATH 上,执行 pulsar publish <path-to-html>,否则静默跳过。\n9) 输出结论:可合并、需修复(含必须修复清单)或需讨论(含架构顾虑),并给出 HTML 路径;不推送不合并。\n\n限制:需 gh、python3 与相应技能环境;未提供收费或价格信息;具体平台支持范围、效果与性能数据暂未提供。
pr-review-html
编程与开发
更新于 10-15 17:18