SuperAPI AI 工具集

review-panel

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:review-panel 是合并前的评审门禁,适用于复杂或风险较高的 diff(涉及认证/隐私/成本/数据丢失/资金/共享契约等),当出错代价不对称时值得动用三个模型。它不是每个任务或每次改动都跑的工具,日常 diff 上运行会浪费 token 并让人习惯性略读结论。若不确定时机与范围,先运行 /review,由编排器决定是否需要面板、单次 /codex-review 还是不评审,并设定轮次预算。建议在接近合并时用 --focus 指向真实风险做一次。

调用:/review-panel [--base <ref> | --staged | --plan <file>] [--reviewers codex,gemini,claude] [--block-at 0-3] [--focus "…" | --focus-file <f>] [--strict] [--out <path>]

规则:全部委托给 review-panel.sh,不要手工运行评审者或重新判定其结论。脚本(review-panel.sh、merge.py)与 sev.schema.json 已提交,评审周期内不得修改;实现者只改源码,不改门禁。不要重新判定面板结论:经过质疑轮后仍存活的 CRITICAL/IMPORTANT 必须修复或升级给人工,不能由本会话辩驳掉。独立性:Claude 评审者以全新 claude -p 进程运行,质疑由其他模型判定,本会话从不评审自己的代码。

门禁退出码:0 干净;1 存在阻断性发现(修复或升级);2 基础设施问题(临时/评审者失败或评审者少于 2 个,不算干净);3 用法错误。

成本:默认 3 个模型 × 1 个 diff;质疑轮仅在跨模型分歧时触发,且只就具体发现重新询问未标记的模型,无循环。

测试(封闭式,不调用真实模型):python3 .claude/skills/review-panel/tests/test_merge.py 运行纯 merge.py 的单元测试(直接运行文件,python3 -m unittest <path> 会因路径非点分模块名而失败);bash .claude/skills/review-panel/tests/run_integration.sh 检查用法门禁、适配器契约存在性,并通过 REVIEW_PANEL_REVIEWER_DIR 的桩评审者做离线端到端(有 bug→1,干净→0,单独被驳倒→0)。设置 REVIEW_PANEL_LIVE=1 可额外调用真实评审者 CLI(codex/gemini/claude),这是唯一消耗模型 token 的路径;CLI 缺失时干净跳过。