定义自定义同步 子代理 为 markdown 文件，以便 Deep Agents Code 可以将专业任务委托给它们。

每个子代理位于其自己的文件夹中，带有 AGENTS.md file:

.deepagents/agents/{subagent-name}/AGENTS.md   # Project-level
~/.deepagents/{agent}/agents/{subagent-name}/AGENTS.md  # User-level

项目子代理会覆盖同名用户子代理（参见 优先级规则).

头部需要 name 和 description （与 SubAgent 字典规范相同）。markdown 正文成为子代理的 system_prompt。除了基础规范外， AGENTS.md 文件支持一个可选 model 头部字段，用于覆盖主代理对此子代理的模型。使用 provider:model-name 格式（例如， anthropic:claude-opus-4-8, openai:gpt-5.5）。省略则继承主代理的模型。

文件格式

子代理 AGENTS.md 文件使用 YAML 头部，后跟 markdown 正文：

---
name: researcher
description: Research topics on the web before writing content
model: anthropic:claude-haiku-4-5-20251001
---

You are a research assistant with access to web search.

## Your Process
1. Search for relevant information
2. Summarize findings clearly

示例：经济高效的子代理

使用更便宜、更快的模型处理简单的委托任务，同时让主代理使用功能更强大的模型：

---
name: general-purpose
description: General-purpose agent for research and multi-step tasks
model: anthropic:claude-haiku-4-5-20251001
---

You are a general-purpose assistant. Complete the task efficiently and return a concise summary.

这会覆盖内置的通用子代理，将所有委托任务路由到更便宜的模型。参见 覆盖通用子代理 了解更多。