SuperAPI AI 工具集

adversarial-review

智能体与模型

查看项目

更新于 10-15 20:27

技能介绍

用途:对代码改动进行对抗式审查。核心思路是让审查者运行在与作者相反的模型上(Claude 生成 Codex 审查者,Codex 生成 Claude 审查者),以避免同模型自我验证。交付物是综合裁决,不执行修改。

主要能力与流程:

  1. 加载原则:读取 brain/principles.md 及其 [[wikilink]] 链接的原则文件,作为审查判断依据。
  2. 确定范围与意图:从上下文(近期 diff、引用的计划、用户消息)确定审查对象,并明确作者意图;审查者挑战的是工作是否达成意图,而非意图本身是否正确。按规模决定审查者数量:小(<50 行、1–2 文件)1 名 Skeptic;中(50–200 行、3–5 文件)2 名 Skeptic + Architect;大(200+ 行或 5+ 文件)3 名 Skeptic + Architect + Minimalist。视角定义见 references/reviewer-lenses.md。
  3. 检测模型并生成审查者:创建临时目录 REVIEW_DIR=$(mktemp -d /tmp/adversarial-review.XXXXXX)。若为 Claude,用 codex exec --skip-git-repo-check -o "$REVIEW_DIR/skeptic.md" "prompt" 2>/dev/null 生成 Codex 审查者;若为 Codex,用 claude -p "prompt" > "$REVIEW_DIR/skeptic.md" 2>/dev/null 生成 Claude 审查者。默认只读,仅在审查者需运行测试时使用 --profile edit。后台运行,通过 TaskOutput(block: true,timeout: 600000)监控。输出文件按视角命名:skeptic.md、architect.md、minimalist.md。每个审查者收到单一提示,包含意图、视角全文、相关原则文件内容、待审代码或 diff,并要求以编号 markdown 列表写出发现,标注 high/medium/low。并行生成所有审查者。
  4. 验证与综合裁决:读取输出前记录所用 CLI 并确认文件存在(echo "reviewer_cli=codex|claude";ls "$REVIEW_DIR"/*.md)。文件缺失或为空需在裁决中注明,不得静默跳过。去重后产出单一裁决,含 Intent、Verdict(PASS/CONTESTED/REJECT)、Findings(按严重度排序,含 file:line、视角、对应原则、具体建议)、What Went Well。裁决逻辑:无 high 为 PASS;有 high 但审查者意见不一致为 CONTESTED;有 high 且一致为 REJECT。
  5. 主导判断:综合后以意图和原则为框架,说明接受或拒绝哪些发现及理由,指出误报、越界和把风格当实质的问题,追加 Lead Judgment。

硬性约束:审查者必须通过相反模型的 CLI 运行,不得使用子代理、Agent 工具或任何内部委派机制,否则会运行在同一模型上,失去对抗意义。

适用场景:需要独立、对抗性代码审查的改动,尤其是中大型 diff。限制:依赖 codex 与 claude CLI 可用;审查者默认只读;不直接修改代码;具体安装与配置方式资料未提供。