subagents

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

DevSpace subagents

DevSpace子代理

Use the DevSpace CLI through the shell or process tool. Run commands from the project the subagent should work on.

通过shell或进程工具使用DevSpace CLI。从子代理应处理的项目中运行命令。

Choose a target

选择目标

Discover usable targets instead of guessing names:

bash

devspace agents targets --json

Configured profiles include a description and may define provider, model, effort, and task instructions. Choose a matching profile when one fits. Use a provider target when no profile fits or a specific provider is needed.

Usually rely on the target's configured model and effort. Pass

--model

--effort

only with a value supported by that provider. DevSpace passes these values through without translating them between providers.

发现可用目标而非猜测名称：

bash

devspace agents targets --json

已配置的配置文件包含描述，可能定义了provider、model、effort和任务说明。当有匹配的配置文件时选择它。当没有合适的配置文件或需要特定provider时，使用provider目标。

通常依赖目标已配置的model和effort。仅当值受该provider支持时，才传递

--model

或

--effort

参数。DevSpace会直接传递这些值，不会在不同provider之间转换它们。

Start work

开始工作

Give the subagent a self-contained brief. Include the objective, relevant paths, constraints, decisions it needs from the current conversation, and the expected result. The subagent receives the brief and its profile instructions, not the parent conversation.

bash

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

The result contains a DevSpace agent

id

and its current status. Execution continues independently, so retain the ID for later inspection or follow-up.

给子代理一个独立的简要说明。包括目标、相关路径、约束条件、当前对话中它需要做出的决策以及预期结果。子代理会收到该简要说明及其配置文件指令，不会收到父对话内容。

bash

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

结果包含一个DevSpace agent

id

及其当前状态。执行会独立进行，因此请保留该ID以便后续检查或跟进。

Inspect and continue

检查与继续

bash

devspace agents show <id> --json
devspace agents continue <id> "<follow-up brief>" --json
devspace agents ls --json

```
show
```
waits briefly for active work, then returns the current status and any available response or error.
```
continue
```
gives the same subagent another turn with its existing provider session and context.
```
ls
```
returns sessions belonging to the current project.

Run

devspace agents show <id> --json

again later while the status is

running

completed

includes the response.

failed

includes a structured error, and

stopped

is terminal without a successful response. Continue an agent when its existing context is useful; start another agent for unrelated work.

bash

devspace agents show <id> --json
devspace agents continue <id> "<follow-up brief>" --json
devspace agents ls --json

```
show
```
会短暂等待正在进行的工作，然后返回当前状态以及任何可用响应或错误。
```
continue
```
让同一个子代理在其现有的provider会话和上下文基础上继续工作。
```
ls
```
返回当前项目的所有会话。

当状态为

running

时，稍后可再次运行

devspace agents show <id> --json

。状态为

completed

时会包含响应内容；

failed

时会包含结构化错误；

stopped

表示任务终止且无成功响应。当现有上下文有用时可继续使用该代理；对于无关工作，请启动另一个代理。

Good uses

适用场景

Review a change for correctness, security, or missing tests.
Investigate a bounded part of a codebase and report findings.
Implement one isolated change with clear acceptance criteria.
Run a focused verification pass after other work.

审查变更的正确性、安全性或是否缺少测试。
调查代码库的某个限定部分并报告发现。
实现一个具有明确验收标准的独立变更。
在其他工作完成后运行一次专注的验证流程。