SuperAPI AI 工具集

adversarial-review

编程与开发

查看项目

更新于 10-15 08:13

技能介绍

用途

对抗性审查用于在需要外部第三方独立视角时,对当前工作(计划、设计、代码或文档)进行审查,或让第三方独立出方案、独立调研后再与我方对照。它适用于需要 second opinion 的场景。内部自检应使用 verify,代码规范检查应使用 code-quality。

主要能力

  • 调用外部 LLM 充当第三方审查者,审查当前工作并逐条验证结论,通过审查循环达成共识。
  • 支持独立出方案 / 独立调研:当用户要第三方从问题出发独立给答案(而非审查已有产物)时,改按 references/independent-work.md 执行,brief 只给用户原话与硬约束、不给我方方案。
  • 运行模式:
    • /adversarial-review:默认审查工作区全部修改(staged + unstaged)
    • /adversarial-review --plan <file>:审查方案/设计文档
    • /adversarial-review --code <file>:审查指定代码文件
    • /adversarial-review --content <file>:审查任意文件内容
  • 审查对象可以是工作区 diff(默认)、指定文件、方案文本,或当前对话中的方案描述。

使用方式

核心工作流为:S1 上下文收集 → S2 构建审查 brief → S3 外部审查调度 → S4 展示审查结论 → S5 逐条验证(含跨轮追踪 + 快照生成)→ S6 用户确认。

  • S1 上下文收集:确定审查对象(默认 git diff + git diff --staged;参数覆盖;对话上下文;兜底询问用户),并收集变更内容、变更原因(WHY)和审查类型。
  • S2 构建审查 brief:打包为结构化审查请求,包含审查类型、变更原因、审查对象、审查维度(正确性、完整性、可行性、风险)和输出要求(id、severity、description、location、suggestion)。
  • S3 外部审查调度:调用外部 LLM 执行审查,采用四级降级链:T1 codex CLI(优先)、T1b codex CLI 备用计费后端(额度耗尽时的首选补救)、T2 codex-mcp(次选)、T3 Task 子 Agent(兜底)。失败需先分类再决定路由;额度类不得降 T2(共用订阅);有输出但无裁决视为截断,不得当审查结果消费;额度耗尽且 T1b 不可用时应报告并停下等用户决定,不自动降 T3;降到 T3 时结论必须标注检出率折损。
  • S4 展示审查结论:必须先原样展示外部审查者的完整发现列表,不做任何修改、过滤或重排。
  • S5 逐条验证:对每条发现进行事实核查、上下文检查和判定(确认/驳回/部分正确),标注严重程度;驳回必须引用具体代码/文档作为反驳证据,确认必须给出成因分析和修复方案;第 2 轮起执行跨轮问题关联并生成本轮结构化快照。
  • S6 用户确认:展示验证结果摘要,用 AskUserQuestion 询问用户接受修复方案、部分接受、全部驳回或结束审查。

审查循环与熔断

  • 加权健康分:health_score = Σ(finding_score),finding_score = base_score(severity, verdict) × origin_multiplier;rejected 不计分。
  • 收敛检测:第 2 轮 score 下降为收敛中,持平或上升为预警;第 3 轮及以后 score 下降且 new_issues == 0 为收敛中,score 下降但 new_issues > 0 为预警,score 持平或上升触发熔断。
  • 安全上限默认 5 轮,触发时强制熔断,用户可在熔断决策时选择解除(将 max_rounds 提升为 current_round + 3)。
  • 熔断复盘按 references/breaker-retro.md 执行 4 步:趋势数据展示 → 根因分析 → 改动合理性评估 → 用户决策(继续 / 接受 / 回退 / 升级)。

适用场景

  • 系统设计审查:设计完成后调用对抗审查验证方案可行性(协作 /system-design)。
  • 开发后代码审查:开发完成后调用进行独立代码审查(协作 /dev-workflow)。
  • 功能评审:功能迭代中对设计方案进行外部挑战(协作 /feature)。
  • 验证互补:verify 检查对齐,adversarial-review 挑战正确性(协作 /verify)。
  • 质量标准参考:代码审查时参考 MTE 原则(协作 /code-quality)。
  • 经验沉淀:反复出现的审查发现沉淀为模式(协作 /compound)。

限制

  • 只读约束:不修改任何被审查文件,只生成报告和修复建议。
  • 必须先理解变更原因(WHY),再开始审查;审查对象必须明确。
  • 首选通道探测仅做一次,冒烟调用必须含一次真实工具调用。
  • 连续 2 轮 primary_method 失败时永久降级;额度类失败不计入该计数。
  • 每轮(含第 1 轮)必须生成轮次快照并追加到 round_history。
  • 报告输出位置为对话中;如需保存,告知用户文件路径建议。
  • 语言:接受中英文输入,统一中文输出。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。