SuperAPI AI 工具集

advise-session

智能体与模型

查看项目

更新于 10-16 03:15

技能介绍

用途:advise-session 与 /advise 的一次性提问不同,它为每个编码代理 CLI 开启真实会话,使各代理能读取项目并记住上一轮内容,从而支持连续追问,例如“为什么”“错误路径怎么办”“你提到的 X 在哪里”,无需反复粘贴上下文。返回一个 researchkit session id,它映射到各厂商的会话 id。

主要能力:从指定仓库运行,代理可读取、glob、grep 项目,但只读,不能写入、编辑或执行 shell 命令。支持 --cwd 指向其他项目、--harnesses 覆盖成员、--context-file 追加上下文、--list 列出已开启会话。--max 使用各代理旗舰模型的高推理档位,单轮可能超过 10 分钟,适合首个问题较难时使用,后续追问继承该模型。

使用方式:在目标仓库中运行 uv run researchkit advise-session "问题",最后一行 stdout 为 session_id: rks_…,保留它用于追问:uv run researchkit advise-session "追问" --session rks_…。列出会话:uv run researchkit advise-session --list。

适用场景:问题有后续追问,或答案依赖当前代码库时。不适用:单个自包含问题(用 /advise 更省)、需要唯一裁决(用 /council)、网络研究(用 /explore)。

限制:成员未安装、未登录或配额耗尽会单独失败并打印原因,其余继续;仅当全部失败时退出码为 1。会话中途失败的成员保留旧 session id,下一轮重新加入。只有 CLI 代理能持有会话,预设中的纯 API 模型 id 会被跳过并提示。会话存储在 ~/.researchkit/sessions/(可用 RESEARCHKIT_SESSIONS_DIR 覆盖),仅所有者可读,且不随代码检出删除。每轮成本与 /advise 相同,约 1–5 分钟,以最慢成员为准,每次代理调用有 30 分钟预算。