~/.deepagents/— Deep Agents 专用数据(代理记忆、技能、会话)~/.agents/— 工具无关数据(跨 AI CLI 工具共享的技能)
目录结构
数据存放位置
优先级规则
当同一项目存在于多个位置时,高优先级完全胜出(不合并)。技能
优先级顺序(从低到高):~/.deepagents/{agent}/skills/— 用户 deepagents~/.agents/skills/— 用户工具无关.deepagents/skills/— 项目 deepagents.agents/skills/— 项目工具无关 (最高)
[skills].extra_allowed_dirs。
子代理
优先级顺序(从低到高):~/.deepagents/{agent}/agents/— 用户级.deepagents/agents/— 项目级 (最高)
name、description、可选 model)和用于系统提示的 markdown 正文的 AGENTS.md 文件。完整格式参考请参阅自定义子代理。
指令
所有指令源组合(而非覆盖):- 包基础提示 (始终加载)
~/.deepagents/{agent}/AGENTS.md(追加).deepagents/AGENTS.md(追加)- 项目根目录的
AGENTS.md(追加)
.deepagents 与 .agents
清理
连接这些文档 到 Claude、VSCode 等,通过 MCP 获取实时答案。

