记忆与技能

深度智能体 CLI 的持久化记忆、AGENTS.md 文件和可复用技能，包括创建、发现和调用。

自定义任何智能体主要有两种方式：

• 记忆：AGENTS.md 文件和自动保存的记忆，跨会话持久化。用于通用编码风格、偏好和已学习的约定。

• 技能：全局和项目特定的上下文、约定、指南或指令。用于在执行特定任务时适用的上下文。

使用 /remember 可以明确提示智能体从当前对话中更新其记忆和技能。

使用 SDK 构建自定义智能体？请参见记忆了解程序化记忆后端。

记忆

自动记忆

当您使用智能体时，它会自动将信息以 markdown 文件的形式存储在 ~/.deepagents/<agent_name>/memories/ 中，遵循记忆优先协议：

1. 研究：在开始任务前搜索记忆中的相关上下文
2. 响应：执行过程中不确定时检查记忆
3. 学习：自动保存新信息供未来会话使用

智能体按主题组织其记忆，使用描述性文件名：

~/.deepagents/backend-dev/memories/
├── api-conventions.md
├── database-schema.md
└── deployment-process.md

当您向智能体传授约定时：

deepagents --agent backend-dev
> Our API uses snake_case and includes created_at/updated_at timestamps

它会在未来会话中记住：

> Create a /users endpoint
# 无需提示即应用约定

AGENTS.md 文件

AGENTS.md 文件提供始终在会话启动时加载的持久化上下文：

• 全局：~/.deepagents/<agent_name>/AGENTS.md — 每次会话都加载。
• 项目：任何 git 项目根目录下的 .deepagents/AGENTS.md — 在该项目内运行 CLI 时加载。

两个文件都会在启动时追加到系统提示中。

记忆工作原理

智能体在回答项目特定问题或您引用过去的工作或模式时，也可能读取其记忆文件。

当您提供关于智能体应如何表现的信息、对其工作的反馈或记住某事的指令时，智能体会更新 AGENTS.md。 如果它从您的交互中识别出模式或偏好，也会更新其记忆。

要在额外的记忆文件中添加更多结构化的项目知识，请将它们添加到 .deepagents/ 中并在 AGENTS.md 文件中引用。 您必须在 AGENTS.md 文件中引用额外的文件，智能体才能知道它们的存在。 这些额外文件不会在启动时被读取，但智能体可以在需要时引用和更新它们。

何时使用全局 vs 项目 AGENTS.md

全局 AGENTS.md（~/.deepagents/agent/AGENTS.md）适用于：

• 您的个性、风格和通用编码偏好
• 通用的语气和沟通风格
• 通用编码偏好（格式化、类型提示等）
• 适用于所有场景的工具使用模式
• 不因项目而异的工作流程和方法论

项目 AGENTS.md（项目根目录下的 .deepagents/AGENTS.md）适用于：

• 项目特定的上下文和约定
• 项目架构和设计模式
• 该代码库特有的编码约定
• 测试策略和部署流程
• 团队指南和项目结构

技能

技能是可复用的智能体能力，提供专业化的工作流和领域知识。 您可以使用技能为深度智能体提供新的能力和专业知识。 深度智能体技能遵循 Agent Skills 标准。 添加技能后，您的深度智能体将自动使用它们，并在您使用智能体并提供额外信息时更新它们。

添加技能

1. 创建技能

   # 用户技能（存储在 ~/.deepagents/<agent_name>/skills/）
   deepagents skills create test-skill
   
   # 项目技能（存储在 .deepagents/skills/）
   deepagents skills create test-skill --project
   

   这会生成：

   skills/
   └── test-skill
       └── SKILL.md
   
2. 编辑 SKILL.md

   打开生成的 SKILL.md 并编辑文件以包含您的指令。

3. 添加可选资源

   可选地向 test-skill 文件夹添加额外的脚本或其他资源。更多信息请参见示例。

您也可以直接将现有技能复制到智能体的文件夹中：

mkdir -p ~/.deepagents/<agent_name>/skills
cp -r examples/skills/web-research ~/.deepagents/<agent_name>/skills/

安装社区技能

您可以使用 Vercel 的 Skills CLI 等工具在您的环境中安装社区 Agent Skills，并使其可供您的深度智能体使用：

# 全局安装技能
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a deepagents -g -y

# 列出已安装的技能
npx skills ls -a deepagents -g

全局安装（-g）将技能符号链接到 ~/.deepagents/agent/skills/ — 默认智能体的用户级技能目录。项目级安装（省略 -g）将技能放置在相对于当前目录的 .deepagents/skills/ 中，使其可供在该项目中运行的任何智能体使用，不受智能体名称的限制。

全局安装仅针对默认的 agent 目录。如果您使用自定义命名的智能体，请使用项目级安装或手动将技能符号链接到 ~/.deepagents/{your-agent}/skills/。

技能发现

启动时，CLI 从深度智能体目录和共享别名目录中发现技能：

~/.deepagents/<agent_name>/skills/
~/.agents/skills/
.deepagents/skills/
.agents/skills/
~/.claude/skills/          （实验性）
.claude/skills/            （实验性）

当存在重名技能时，后发现的目录会覆盖先发现的（参见应用数据）。

对于项目特定的技能，项目的根文件夹必须有一个 .git 文件夹。 当您从项目文件夹内的任何位置启动 CLI 时，CLI 会通过检查包含的 .git 文件夹来找到项目的根文件夹。

对于每个技能，CLI 从 SKILL.md 文件的 frontmatter 中读取名称和描述。 在使用 CLI 的过程中，如果任务匹配技能的描述，智能体将读取技能文件并遵循其指令。

您也可以使用 /skill:<name> [args] 直接调用技能。技能发现在启动时和 /reload 时运行。

从命令行调用技能

使用 --skill 在启动时调用技能，无需交互式输入斜杠命令：

# 打开 TUI 并立即运行技能
deepagents --skill code-review

# 使用 -m 向技能传递请求
deepagents --skill code-review -m 'review the auth module'

# 通过管道将内容传入技能
cat diff.txt | deepagents --skill code-review

# 管道传入内容并添加请求
cat diff.txt | deepagents --skill code-review -m 'focus on security'

--skill 也适用于非交互模式：

# 无界面运行技能
deepagents --skill code-review -n 'review this patch'

# 安静模式（仅智能体输出到 stdout）
deepagents --skill code-review -n 'review this patch' -q

--skill 与 --quiet 或 --no-stream 一起使用时需要 -n（非交互模式）。

列出技能

# 列出所有用户技能
deepagents skills list

# 列出项目技能
deepagents skills list --project

# 获取特定技能的详细信息
deepagents skills info test-skill
deepagents skills info test-skill --project

---

通过 MCP 连接这些文档到 Claude、VSCode 等以获取实时解答。

在 GitHub 上编辑此页面 或 提交 issue。