SuperAPI AI 工具集

panel

智能体与模型

查看项目

更新于 10-23 16:18

技能介绍

用途

Panel 把同一个任务同时交给四个智能体命令行工具(grok、claude、codex、agy)执行,每个 CLI 运行在自己的子代理中,以无头方式运行,最后把四份结果按同意程度聚类成一份共识报告。它的核心价值在于用四个独立模型对同一任务给出交叉判断,而不是依赖单一模型的结论。

两种任务形态

  • 提示词(Prompt):用户的文本原样、逐字发送给四个 CLI,四份结果可以直接比较。
  • 评审(Review):固定一个 diff 范围,要求四个 CLI 在只读条件下评审同一范围。评审时按 code-review 的方式固定基准点,diff 为 git diff <fixed-point>...HEAD(三点,对 merge-base),用户未指定时默认为 main;对未提交的在制品则去掉 ...HEAD,以覆盖暂存和未保存的改动。派发前需确认 ref 可解析(git rev-parse <fixed-point>)、记录 git rev-parse HEAD,并确认 diff 非空,坏 ref 应在此处失败,而不是在四个子代理内部失败。

执行流程

  1. 读取任务并选择形态,然后写出唯一的任务字符串;四个 CLI 收到完全相同的字符串。任务开头会加一行声明,要求每位评审者自行直接回答,不得再启动 panel、其他 CLI 或子代理。
  2. 用 command -v 检查 grok、claude、codex、agy 是否存在,缺失者记入最终报告;若剩余不足两个,则没有可形成的共识,报告缺失项后停止。
  3. 为每个存在的 CLI 并行派发一个子代理(在单条消息中一次性派发)。每个子代理获得同一任务文件路径和一份说明。路径必须写全,不能使用运行期计算的命令替换;claude 与 codex 从 stdin 读取任务,grok 用 --prompt-file,agy 没有文件或 stdin 形式,需以单引号字面量内联任务文本。每个 CLI 只运行一次、无头、从仓库根目录启动,且不得添加 --model。
  4. 所有 CLI 必须以后台方式运行(run_in_background: true,输出重定向到临时文件),避免被前台 10 分钟上限中途杀掉;不支持后台模式的 shell 工具则使用最大超时前台运行。等待时只用一次调用,不要轮询。
  5. 每个 CLI 的返回被蒸馏为 { cli, status, points[] },每个点包含一行主张、位置(file:line 或 general)和一行理由,丢弃日志、思考与散文。
  6. 先检查是否达到法定人数:至少两个 CLI 已响应(而不仅是存在)。随后把表述不同但主张相同的点合并,按响应者数量 N 的比例分级:Unanimous(全部 N)、Majority(超过一半但非全部)、Split(正好一半,仅 N 为偶数时)、Lone(不足一半)、Conflict(CLI 之间直接冲突)。
  7. 按最一致在前输出聚类,节标题为 ## Unanimous、## Majority、## Split、## Lone、## Conflict(空节跳过),每点一行:主张、位置、提出该点的 CLI(如 [claude, codex, grok])以及一行理由;冲突需写明双方及各自持有者。评审形态下若宿主提供 ReportFindings,则通过它一次性上报聚类,Unanimous 与 Majority 的 verdict 为 CONFIRMED,低于此的为 PLAUSIBLE,只能用 markdown 打印通用点和冲突。最后给出一行摘要:各等级点数、响应者数量 N、缺失或出错的 CLI,并通知用户已就绪。

后续步骤

报告结尾附推荐后续步骤:把所有等级(含 Lone)的点列成一份修复清单,不做筛选;冲突点列出双方并说明代码支持哪一方。随后提供快捷方式,询问是否验证并应用整个清单为一个提交,例如“回复 fix all 以验证并应用全部 11 个点”。用户回复 fix all 时,逐点对照代码验证,成立则应用,不成立则给出一行理由;不得只应用有把握的子集。

安全与限制

无头模式会自动批准所有工具,因此每个 CLI 即使被要求只读,理论上仍可能写入文件。防护有两层:在干净工作树上运行 panel;评审形态下按第 3 步做 worktree 隔离或回滚越界写入(对已提交范围使用 isolation: "worktree" 并在说明中先 git checkout --detach <HEAD sha>;对在制品则先保存 git status --porcelain 与 git diff 作为基线,每个子代理返回后比对,将基线中干净而被改动的路径还原并点名对应 CLI,基线中已脏的路径属于用户未保存工作,只报告不动)。各 CLI 的只读 flag 行为不一致(codex --sandbox read-only 可用,agy --mode plan 会把任务劫持为规划,grok 的 profile 名与机器相关),因此只读靠第 3 步的隔离或回滚来保证,而不是靠 flag。每个 CLI 使用自身最新/默认模型,禁止传 --model,因为 panel 的意义就是四个独立模型,固定模型会破坏这一点。资料未提供安装方式、收费、价格与具体平台要求。