Skip to main content
Deep Agents CLI 将数据存储在两个目录层级中:
  • ~/.deepagents/ — Deep Agents 专用数据(代理记忆、技能、会话)
  • ~/.agents/ — 工具无关数据(跨 AI CLI 工具共享的技能)

目录结构

数据存放位置

优先级规则

当同一项目存在于多个位置时,高优先级完全胜出(不合并)。

技能

优先级顺序(从低到高):
  1. ~/.deepagents/{agent}/skills/ — 用户 deepagents
  2. ~/.agents/skills/ — 用户工具无关
  3. .deepagents/skills/ — 项目 deepagents
  4. .agents/skills/ — 项目工具无关 (最高)
加载技能时,CLI 会验证解析后的文件路径是否保持在这些目录之一内。解析到所有技能根目录之外的符号链接将被拒绝。要允许其他目录中的符号链接目标,请参阅 [skills].extra_allowed_dirs

子代理

优先级顺序(从低到高):
  1. ~/.deepagents/{agent}/agents/ — 用户级
  2. .deepagents/agents/ — 项目级 (最高)
每个子代理都是一个带有 YAML frontmatter(namedescription、可选 model)和用于系统提示的 markdown 正文的 AGENTS.md 文件。完整格式参考请参阅自定义子代理

指令

所有指令源组合(而非覆盖):
  1. 包基础提示 (始终加载)
  2. ~/.deepagents/{agent}/AGENTS.md (追加)
  3. .deepagents/AGENTS.md (追加)
  4. 项目根目录的 AGENTS.md (追加)

.deepagents.agents

对于可与任何 AI 编码助手配合使用的技能,请使用 .agents/skills/。 对于依赖 Deep Agents 特定工具或约定的技能,请使用 .deepagents/skills/

清理

删除 ~/.deepagents/sessions.db 将移除所有对话历史和检查点。 此操作无法撤销。