SuperAPI AI 工具集

dym-arex-skill-chay-viec-researcher

智能体与模型

查看项目

更新于 10-18 01:23

技能介绍

用途

dym-arex-skill-chay-viec-researcher 是一个在 DisCo 中以 Researcher 模式(shell)运行研究任务的技能。它是日常主要使用路径:用户给出一个具体的研究目标,由路由器选择技能,智能体自动运行并自我验证。

主要能力

  • 以 Researcher 模式运行研究任务(Researcher 是默认模式)。
  • 产出会话文件、工作目录中的真实产物(脚本、配置、测量数据),以及按 --mode 输出到 stdout 的内容。
  • 支持交互式运行与单次执行后退出(-p / --print)。
  • 支持直接调用指定技能,跳过路由器步骤,节省轮次并便于审计。
  • 支持运行 Creator 构建的、面向具体任务的图(graph)任务。
  • 支持多种输出协议(--mode text|json|rpc),与智能体模式(--creator/--researcher)相互独立。

使用方式

交互式运行:

disco                      # Researcher 是默认模式
disco --researcher         # 显式指定,创建新会话

单次执行后退出:

disco -p "Fix the failing tests in this repository and run the relevant test suite"

disco --researcher -p "Benchmark vLLM and SGLang with the same model and workload on this machine. Tune each server under identical hardware and memory constraints, report the best verified throughput for each, and preserve the commands and measurements needed to reproduce the comparison."

print 模式的退出码(来自 modes/print-mode.ts,而非 README):

情况 退出码
正常完成 0
assistant 最后一条消息的 stopReason 为 error 或 aborted,错误输出到 stderr 1
收到 SIGHUP 129
收到 SIGTERM 143

即:exit 0 不保证研究任务成功,只保证会话无错误结束。要保证质量需自行检查其产物。

直接调用某个技能(已知确切需求时):

disco --researcher -p "/skill:vllm determine and verify the highest-throughput vLLM configuration for <model and workload>"

命令命名约定为 skill:<技能名>(在 agent-session.ts / interactive-mode.ts / rpc-mode.ts 中构建)。直接调用会跳过路由器步骤,节省轮次且更易审计。

显式调用路由器(即使已禁用路由器):

disco --researcher -p "/skill:repo-skills-router <任务描述>"

运行 Creator 构建的面向具体任务的图:

disco --researcher -p "/skill:<graph-entry> Complete <research task> within <environment and budget constraints>, and verify it with <evaluator>."

图的部署位置(记录在 Creator 的 handoff 中):

  • 绑定到具体 task/project/dataset/evaluator/机器,或不确定能否复用 → <project-dir>/.agents/skills/,仅在项目被 trust 后加载。
  • 自包含、有 provenance、已跨多个项目交叉验证 → 才建议放到 ~/.disco/agent/skills/。
  • 一个图绝不会被拆分到两个 scope 中。

常用参数:

# 机器可读输出:每行一个 JSON 事件
disco --mode json -p "..." > events.jsonl

# 只读模式(不能修改文件)
disco --tools read,grep,find,ls -p "Review the code in src/"

# 屏蔽某个工具,保留其余
disco --exclude-tools ask_question -p "..."

# 会话
disco --continue "What did we discuss?"     # 续接上一个会话(-c)
disco --resume                              # 选择会话续接(-r)
disco --name "Refactor auth module"         # 命名会话(-n)
disco --no-session -p "..."                 # 临时会话,不保存

# 向首条消息加载额外文件
disco @prompt.md "Use this plan while creating the skill"

# 导出会话为 HTML 后退出
disco --export session.html

# thinking 级别
disco --thinking high -p "..."     # off|minimal|low|medium|high|xhigh|max

--mode text|json|rpc 选择输出协议,与智能体模式(--creator/--researcher)完全独立。

路由器行为(便于正确阅读日志)

对于合适的请求,DisCo 会读取 repo-skills-router,打开 1–2 个可能的 area 页面,比较 family 页面,然后才读取被选中的技能(例如 vllm/SKILL.md、sglang/SKILL.md)。它不会把 1,000 个技能的描述或内容塞进初始上下文。看到它在真正工作前读取 3–4 个路由器文件是正常的,不是浪费。

适用场景

  • 需要以具体、可验证目标驱动研究任务,并保留可复现命令与测量数据。
  • 需要直接调用已知技能、跳过路由器以节省轮次并便于审计。
  • 需要运行 Creator 构建的、面向具体任务的图任务。
  • 需要机器可读输出(json)、只读审查、会话续接或命名等日常操作。

限制与注意事项

  • 安装/更新后必须打开新会话。正在运行的会话看不到新技能。
  • 任务描述必须是具体、可验证的结果。“了解 vLLM”路由器无从下手;“测量 vLLM 与 SGLang 在相同模型/负载下已验证的吞吐量,保留可复现命令”则可以。
  • 模式混淆:若请求属于另一模式,DisCo 会在开始前停止并建议切换模式,绝不会暗中自动切换模式。
  • 多消息 prompt:disco "msg1" "msg2" 按顺序发送;在 print 模式下只有 assistant 最后一条消息决定退出码。
  • exit 0 不保证研究任务成功,需自行检查产物质量。

后续步骤

  • 想在 Claude Code / Codex 中使用技能而非在 DisCo 中 → 04-xuat-skill-sang-agent-khac.md
  • 想创建新技能 → 05-creator-tao-repo-skill.md