remember

回顾我们的对话，并沉淀有价值的知识。请特别关注我们讨论或发现的最佳实践，这些是最需要保留的内容。

第 1 步：识别最佳实践与关键经验

扫描对话，寻找以下内容：

最佳实践（最高优先级）

• 行之有效的模式：我们发现效果良好的方法、技巧或解决方案
• 需要避免的反模式：导致问题的错误、陷阱或做法
• 质量标准：我们为优质代码、文档或流程确立的标准
• 决策依据：我们为何选择某一方案而非另一方案

其他有价值的知识

• 编码约定与风格偏好
• 项目架构决策
• 我们制定的工作流与流程
• 值得记住的工具、库或技巧
• 我对你行为或输出给出的反馈

第 2 步：决定每条经验的存储位置

针对每条最佳实践或经验，选择合适的存储位置：

-> 记忆（AGENTS.md），用于偏好与指导原则

在以下情况下使用记忆：

• 属于偏好或指导原则（而非多步骤流程）
• 需要时刻牢记的内容
• 简单的规则或模式

全局（$DEEPAGENTS_HOME/agent/AGENTS.md）：适用于所有项目的通用偏好 项目（.deepagents/AGENTS.md）：项目特定的约定与决策

-> 技能，用于可复用的工作流与方法论

在以下情况下创建技能，即我们已经制定了：

• 值得复用的多步骤流程
• 针对某类任务的方法论
• 内嵌最佳实践的工作流
• 需要被一致遵循的操作步骤

技能比记忆条目更强大，因为它们能够编码如何把事情做好，而不仅仅是记住什么。

第 3 步：为重要的最佳实践创建技能

如果我们围绕某个工作流或流程确立了最佳实践，请将其沉淀为技能。

**示例：**如果我们讨论过代码审查的最佳实践，就创建一个 code-review 技能，将这些实践编码为可复用的工作流。

技能位置

$DEEPAGENTS_HOME/agent/skills/<skill-name>/SKILL.md

技能结构

skill-name/
├── SKILL.md          (required - main instructions with best practices)
├── scripts/          (optional - executable code)
├── references/       (optional - detailed documentation)
└── assets/           (optional - templates, examples)

SKILL.md 格式

---
name: skill-name
description: "What this skill does AND when to use it. Include triggers like 'when the user asks to X' or 'when working with Y'. This description determines when the skill activates."
---

# Skill Name

## Overview
Brief explanation of what this skill accomplishes.

## Best Practices
Capture the key best practices upfront:
- Best practice 1: explanation
- Best practice 2: explanation

## Process
Step-by-step instructions (imperative form):
1. First, do X
2. Then, do Y
3. Finally, do Z

## Common Pitfalls
- Pitfall to avoid and why
- Another anti-pattern we discovered

核心原则

1. 突出编码最佳实践：将其放在靠前位置，使其指导整个工作流
2. 简明为要：只包含非显而易见的知识。每个段落都应证明其 token 成本的合理性。
3. 明确的触发条件：description 决定技能何时激活，因此要具体
4. 使用祈使句：以命令形式书写，例如"创建一个文件"，而不是"你应该创建一个文件"
5. 包含反模式：不应做什么，往往与应做什么同样有价值

第 4 步：为较简单的经验更新记忆

对于偏好、指导原则和不足以单独成为技能的简单规则：

## Best Practices
- When doing X, always Y because Z
- Avoid A because it leads to B

使用 edit_file 更新现有文件，使用 write_file 创建新文件。

第 5 步：汇总变更

列出你沉淀的内容及其存储位置：

• 已创建的技能（及其编码的关键最佳实践）
• 已新增的记忆条目（及其位置）