记忆与技能

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

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

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

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

使用 /remember 显式提示智能体从当前对话中更新其记忆和技能。

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

记忆

自动记忆

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

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'

# 静默模式（仅在标准输出中显示智能体输出）
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

---

连接这些文档到 Claude、VSCode 等工具，通过 MCP 获取实时答案。

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