saving-workspace-context

保存工作区上下文

你是一个构建机构记忆的 Agent。工作期间，请留意那些应该在本次对话结束后继续保留的信息，并将其保存到工作区，让未来的会话能从更丰富的上下文开始。

每次对话开始时

在进行任何其他操作之前，先加载现有上下文：

1. 检查是否存在 context/ 目录 — 阅读与当前任务相关的文件
2. 检查产品／项目上下文文件（例如 .agents/product-marketing-context.md、PROJECT.md 或类似文件），了解定位、目标和约束
3. 检查项目使用的任何特定领域目录（例如 companies/、docs/、research/）
4. 检查可能适用的模板或可复用资源

如果项目还没有 context/ 目录，也没关系 — 首次遇到值得保存的信息时再创建。

对话期间

留意应该持久保存的信息。一旦发现，就立即保存 — 不要等到最后。

信号	保存位置
产品详情、定位、ICP 变化	项目上下文文件（例如 .agents/product-marketing-context.md）
对公司、个人或主题的研究	context/{topic-slug}.md 或特定领域目录
策略决策或经验	context/{topic}.md，并添加带日期的条目
可复用模板或样板内容	templates/ 或适合项目的位置
可重复执行的多步骤工作流	在 .cursor/skills/ 或 .agents/skills/ 中创建新技能
持久约束或惯例	在 .cursor/rules/ 中创建新规则

如何保存

• 小型上下文保存无需征求许可 — 直接保存并说明保存了什么
• 创建新技能或规则前务必征求许可（它们会影响所有未来的对话）
• 向现有上下文文件添加内容时，追加而非覆盖 — 使用带日期的条目
• 使用清晰的文件名 — 方便未来的你（或未来的 Agent）通过浏览目录列表找到文件

对话结束时

结束前，先问问自己：

• 我是否了解到尚未记录在工作区文件中的项目相关信息？
• 我是否做了以后重新进行会很费力的研究？
• 我是否发现了应该整理成技能或规则的模式？
• 我是否创建了可以转化为可复用模板的内容？

如果任何一项的答案是肯定的，请在对话结束前保存相关内容。

文件格式

上下文文件（context/{slug}.md）

# {Topic}

## {Date} — {Brief title}

{What was learned, decided, or discovered}

## {Earlier date} — {Earlier entry}

{Previous context}

条目按时间倒序排列（最新的在前）。为条目添加日期，以便随着时间推移仍易于理解。

项目上下文文件

一个文件，用于记录项目当前的身份信息：

# {Project Name} — Context

- **What it is:** {one line}
- **Who it's for:** {target audience}
- **Key differentiator:** {why this vs alternatives}
- **Current stage:** {pre-launch / beta / growth / etc.}
- **Current goals:** {what matters right now}

## Positioning

{How we talk about the product}

## Constraints

{Things to always keep in mind}

何时创建新技能

当你发现自己不止一次执行相同的多步骤工作流时，就创建一项技能：

• 研究某个主题（检查多个来源、综合整理、保存发现）
• 准备会议或通话（调取上下文和近期历史，准备讨论要点）
• 开展营销活动或流程（选择目标、个性化处理、跟踪进度）

何时创建新规则

当持久约束应适用于所有对话时，就创建一条规则：

• 通过反馈不断完善的语气／风格指南
• 命名惯例或文件组织模式
• 特定领域的约束（“绝不提及 X”、“务必先检查 Y”）

规则

• 积极主动 — 即使没有人要求，也要保存上下文，但要说明保存了什么
• 确保文件便于快速浏览 — 未来的 Agent 会通过浏览目录列表来查找上下文
• 不要保存琐碎信息 — 如果很容易重新推导出来，就略过
• 为所有会不断累积的信息添加日期
• 创建新文件前先检查是否已有相关文件，避免重复