用途
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>
适用场景
- 审查变更的正确性、安全性或缺失的测试。
- 调查代码库中一个有边界的部分并报告发现。
- 在明确的验收标准下实现一个隔离的变更。
- 在其他工作之后运行一次聚焦的验证。
限制
资料未提供关于计费、价格、平台兼容性、性能效果或具体模型支持范围的信息,这些方面暂未提供。