SuperAPI AI 工具集

advise

智能体与模型

查看项目

更新于 10-16 07:48

技能介绍

用途

advise 的核心用途是:把同一个问题并行发送给每一个已登录的订阅制 CLI 工具,并把每个回答原样、带标签地返回。它的价值在于未经综合的对比——你可以看到四家不同厂商的旗舰模型在哪里一致、在哪里分歧。整个流程完全运行在已登录的 CLI 订阅之上,不读取任何 API 密钥。

适用与不适用场景

适用:观点类问题、设计决策、取舍检查,以及“用多个模型对这个想法做一次合理性检查”。

不适用:需要单一决定性答案(应使用 /council)、实时网络研究或引用(应使用 /explore),以及任何需要访问仓库文件的场景——各成员仅凭模型自身知识作答。

使用方式

从 researchkit 仓库根目录运行(或用 --directory 指向某个检出目录):

uv run researchkit advise "QUESTION"
uv run researchkit advise "QUESTION" --context-file notes.md   # append context
uv run --directory /path/to/researchkit researchkit advise "QUESTION"

读取输出:每个成员对应一个 ## <harness-spec> 段落。失败的成员会打印 *failed: <reason>*,且不会阻塞其他成员;stderr 末尾会显示 N/5 harnesses answered。

将各回答并排转述,并标注来源。不要把它们合并成一个答案——如果用户想要综合,应改用 /council。

默认成员来自 models.yaml 中的 harness 预设(claude:claude-opus-5@xhigh、codex:gpt-6-astra@xhigh、agy:gemini-3.8-flash-high、grokcli:grok-4.6、kimicli:kimi-code/k3)。可在单次运行时覆盖:--harnesses codex:gpt-6-astra grokcli:grok-4.6(在 CLI 支持的情况下,@<effort> 后缀用于设置推理强度)。uv run researchkit doctor --preset harness 可在消耗任何额度之前校验每个固定配置。

失败模式

某个 harness 未安装、未登录或订阅额度用尽(“usage limit”“Individual quota reached”)时,只会导致该成员失败——原因会内联打印;仅当所有成员都失败时退出码才为 1。

要求这些 CLI 已登录(claude、codex、agy、grok login、kimi login)——按设计没有 API 密钥回退方案。

预计墙钟时间约 1–5 分钟(并行执行,最慢的成员决定总时长)。每次 harness 调用有 30 分钟预算——在高推理强度下,密集的提示词确实可能超过 10 分钟,而更紧的时限只会把最慢的成员(通常是 codex)变成 *failed: timed out* 一行。如需硬性上限,可用 RESEARCHKIT_CLI_TIMEOUT=<seconds> 覆盖。