SuperAPI AI 工具集

orca-replay

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:OrcaReplay 用于回答关于过去智能体运行的问题。它要求:当问题涉及已经发生的事,先读取运行记录(trace)再作答,不要凭记忆重建;若存在录制,即使猜测可能正确也不应猜测。

主要能力:通过 orca_list_runs 查找运行(最新优先,并标明每个分叉来自哪次运行);用 orca_graph 配合 to: <event seq> 只返回产生某个事件的因果链,用于回答“为什么”,而完整时间线(orca_show_run)用于回答“发生了什么”;区分证据与推断,每条边标注为 recorded(记录器实际观察到)或 inferred(依据具名规则推导);用 orca_replay 离线重跑录制并报告无法复现的部分;仅在用户要求时用 orca_compare 将一次运行从同一检查点分叉到多个模型,以 shell 命令退出码作为评判。

使用方式:直接以自然语言提问,例如“为什么上一次运行覆盖了 src/config.ts?”或“昨天的失败还能复现吗?”。回放时可传 worktree: true;否则回放期间会用录制的文件系统覆盖工作树,未提交的改动会暂时缺失,若回放中断则持续缺失。首次回放前应确认哪些内容会重新执行:模型回答来自 trace,但智能体进程会真实重跑,其 shell 命令也会再次执行。

适用场景:追问某次运行为何删除/覆盖/移动文件、哪个步骤破坏了构建、能否复现昨天的失败、换模型是否会做对等。

限制:回放不是沙箱,只阻断模型提供方出口流量,不阻断网络;回放匹配不等于确定性结论,因为模型不会被重新询问,只是回放录制的回答,无法说明全新运行是否会同样失败;reused=3/5 通常不是失败,因为测试框架自身会发起配额探测、会话命名等调用而回放不重复;没有录制就没有答案,应明确说明并建议用 orca record claude 开始录制。要求:orcareplay npm 包(Node 20+),其 MCP 服务器注册为 orca,且项目 .orca/runs 目录中至少有一次录制运行。许可证 Apache-2.0,仓库 Continuum-AI-Corp/OrcaReplay。