SuperAPI AI 工具集

multi-specialist-review

智能体与模型

查看项目

更新于 10-16 01:37

技能介绍

用途:面向 PR 级别改动的团队式代码评审。适用于 5 个以上改动文件、多提交范围(main..feature-branch)、安全敏感路径(认证、加密、支付、输入校验),或单轮专家评审已标记需深入核查的场景。原子提交评审应改用 agent-loops 的 specialist-review.sh,成本低 4-6 倍。

主要能力:并行启动 3-5 个专家子智能体,各自阅读真实源文件而非仅看 diff,覆盖多视角;用 verify_citations.py 机械校验每条发现(文件存在、行号在文件长度内、引用代码出现在引用行附近 ±5 行,空白归一化),失败者带原因剔除;编排者合成时按文件+行去重、取最高严重级、标注 multi-perspective、顺序编号,输出最终 markdown。

使用方式:仅限 Claude Code,需具备 Agent 工具与 code-reviewer 子智能体类型,无法从 Codex、Gemini 或外部 shell 调用。阶段 0 生成 diff 并选视角:git diff main..HEAD -- src/ > /tmp/review-diff.patch,再运行 python3 skills/multi-specialist-review/scripts/triage_perspectives.py /tmp/review-diff.patch。阶段 1 在单条消息内对每个视角发起一次性 Agent 调用以并行执行,参数含 subagent_type="code-reviewer"、model="sonnet",结果写入 .agents/reviews/specialist-{perspective}-{timestamp}.json。阶段 2 运行 python3 skills/multi-specialist-review/scripts/verify_citations.py .agents/reviews/specialist-*.json > .agents/reviews/verified-findings.json。阶段 3 由编排者依 synthesis-prompt.md 合成,写入 .agents/reviews/review-{timestamp}.md。阶段 4 运行 python3 skills/agent-loops/scripts/validate-review-contract.py code-review .agents/reviews/review-{timestamp}.md 校验,返回该路径给用户。

限制:成本约每次 2-3 美元;必须用一次性 Agent 调用,禁用 TeamCreate、team_name=、TaskCreate,否则子智能体只继承协调工具而无 Read/Grep/Glob/Write/Bash,会出现只口述读文件却不调用工具;不得顺序启动、不得跳过引用校验、合成不再另开智能体、不得评审自己代码、不得由智能体自主调用。平台与定价之外的其他细节暂未提供。