SuperAPI AI 工具集

subagents

智能体与模型

查看项目

更新于 10-15 15:28

技能介绍

用途

DevSpace subagents 用于将聚焦的编码、研究、审查或验证工作委派给一个有明确边界的 DevSpace 子代理。子代理是可选的:日常任务应使用常规工作区工具,只有当独立上下文、专门化能力或后续跟进能带来实质帮助时才进行委派。

主要能力

  • 通过 shell 或进程工具,在子代理应使用的项目目录中运行 DevSpace CLI。
  • 代理命令默认打印紧凑的 XML 片段,应直接读取该输出,不要添加 --json。
  • 支持发现可用目标、启动任务、等待或查看状态、继续关联工作。

使用方式

选择目标

先发现可用目标,而不是猜测名称:

devspace agents targets

每一行是一个 <provider name="..."/> 或 <profile name="..." provider="...">description</profile> 片段。将 profile 或 provider 名称作为 <profile-or-provider> 传入。优先选择匹配的 profile;当没有合适的 profile 或任务需要特定 provider 时,使用 provider 目标。除非任务需要受支持的覆盖,否则保持已配置的模型和 effort。

启动工作

给子代理一份自包含的任务简报,包含目标、相关路径、约束、它无法推断的上下文以及预期结果。子代理只会收到该简报及其 profile 指令,不会收到父对话内容。

devspace agents run <profile-or-provider> "<brief>"
devspace agents run <profile-or-provider> --model <model> --effort <effort> "<brief>"

命令返回一个 <agent id="agt_..." status="running"/> 回执。保留该 DevSpace agent ID,以便检查、等待或后续跟进。

等待或查看

当工作必须先完成才能继续时使用 wait。一次调用可以等待多个代理:

devspace agents wait <id>
devspace agents wait <id> <id> <id>
devspace agents wait <id> <id> --timeout 60

不带 --timeout 时,命令会等待所有指定代理的当前工作完成。超时会按首次出现顺序,为每个唯一代理返回一个片段;未完成的工作带有 status="running" wait="timeout"。已完成的工作,其输出就是元素文本。失败会包含 code 和 retryable 属性。该命令不会流式返回部分结果。

使用 show 获取即时快照。当 wait 能表达依赖关系时,不要轮询 show。

devspace agents show <id>
devspace agents ls

ls 列出当前项目的代理。空目标与 ls 结果不打印任何内容。

继续关联工作

当代理已有的 provider 上下文有帮助时,继续该代理;无关工作则启动另一个代理。

devspace agents continue <id> "<follow-up brief>"
devspace agents wait <id>

适用场景

  • 审查变更的正确性、安全性或缺失的测试。
  • 调查代码库中一个有边界的部分并报告发现。
  • 在明确的验收标准下实现一个隔离的变更。
  • 在其他工作之后运行一次聚焦的验证。

限制

资料未提供关于计费、价格、平台兼容性、性能效果或具体模型支持范围的信息,这些方面暂未提供。