SuperAPI AI 工具集

review-local

通用与其它

查看项目

更新于 10-16 09:56

技能介绍

用途:在当前分支上运行本地 AI 审查收敛循环,作为代码质量检查点,可在推送前、开发中途或独立于 /ship 使用。无需 GitHub 或 PR。

主要能力:脚本会把便携式 PR 审查包暂存到 tmp/ship/pr-review-plugin/,并行调度 17 个领域专属审查器(各自独立会话),汇总发现为结构化审查摘要;当存在阻塞性发现时,运行有界的修复收敛循环。

使用方式:脚本路径相对 /ship 技能目录,位于 plugins/eng/skills/ship/scripts/run-local-review.sh。必须使用绝对路径,并确保 CWD 位于目标仓库,因为脚本通过 git rev-parse --show-toplevel 从调用时的 CWD 解析仓库根目录。应使用 run_in_background: true 运行,因为并行审查和修复常超过 600 秒 Bash 超时。常用命令示例:--target <branch> 指定对比分支,--max-fix-passes <n>(默认 5)限制修复次数,--docker 在仓库 Docker 沙箱运行,--spec <path> 指定 SPEC.md,--allow-blocking 接受阻塞结果并以退出码 2 返回 allow_blocking 而不进入修复循环。

输出文件:全部写入 tmp/ship/,包括 review-output.md(最新摘要)、review-status.json(解析后的推荐、风险、问题计数、阻塞标志、deferredFindings[])、review-iteration-log.md(完整审查/修复历史)、local-review-runs/<run-id>/(每次审查的取证轨迹)。退出时 stdout 输出三段结构:LOCAL REVIEW EXIT 信封、REVIEW STATUS、REVIEW ITERATION LOG(仅非零退出时)。退出原因包括 converged(0)、fixer_no_changes(2)、max_passes_exhausted(2)、allow_blocking(2)、fatal_error(1)。

适用场景:功能分支上的质量门;/ship 在 Phase 4 与 Phase 6 直接调用同一脚本,但 /ship 不加载此技能。也可在没有 /ship 工件时独立使用,此时会创建 tmp/ship/,在缺少 state.json 时从 package.json 检测质量门(test、typecheck、lint 脚本),缺失的 /ship 专属文件以 Not available. 呈现。

限制与注意:不要过度准备,不要代替用户创建分支、暂存或提交,脚本基于当前分支状态(已提交+暂存+未暂存)。不要盲目应用每条建议,需结合 diff、代码库模式与意图验证。若手动评估发现,先通过 Skill 工具调用 /assess-findings。评估完成后,将 Future-relevant: Yes 的已拒绝发现追加为 review-status.json 的 deferredFindings 数组,供 /ship 持久化到 state.json 的 deferredScope[] 并在 Ship Summary 展示;无相关项时设为空数组。资料未提供收费、价格等信息。