代码 AI 记忆系统
持久项目记忆：规则文件、记忆文档与向量召回。
智能体开发高级
为什么
MCP 参考服务器仓库约有 9 万 GitHub star，代理 AI 基金会成员从 2025 年 12 月的 49 个创始成员增长到 2026 年 8 月的 247 个，显示多智能体生态快速增长。无记忆则每会话从零开始并重学约定。
记忆系统（规则文件 + 记忆文档 + 可选向量库）使智能体积累项目知识，故第 N+1 会话优于第 N。
何时使用
为长期项目且反复使用智能体时建记忆系统。一次性脚本跳过。
如何做
1. 规则文件（.cursorrules / CLAUDE.md）：静态约定，始终加载。
2. 记忆文档（MEMORY.md）：仅追加的决策、坑、修复日志。
3. 向量召回（可选）：索引过往 diff/issue 供语义查找。
4. 每会话智能体读规则 + 记忆；追加新学。
5. 定期修剪记忆文档保持相关。
示例
# MEMORY.md（仅追加）
- 2026-09-12：src/api zod 迁移完成；任何地方勿用 assertValid。
- 2026-09-20：限流用 Redis key ratelimit:{ip}；TTL 60s。
CLAUDE.md 引用 MEMORY.md："过往决策见 MEMORY.md"。
常见问题
- ⚠错误：智能体在同一工具调用上死循环 → 加最大迭代守卫和最近 N 步动作去重检查。
- ⚠Error: Cannot find module '@modelcontextprotocol/sdk' → `npm install @modelcontextprotocol/sdk`；智能体需 SDK 调用 MCP 工具。
- ⚠错误："Tool timed out after 30000ms" → 调大超时配置或将任务拆成智能体可增量完成的小子任务。
最佳实践
- ✓规则短且权威；历史放 MEMORY.md。
- ✓每条记忆加日期以便按龄修剪。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是代码 AI 记忆系统？
持久项目记忆：规则文件、记忆文档与向量召回。 它可帮助开发者快速理解 代码 AI 记忆系统 的核心价值与适用场景。
如何开始使用代码 AI 记忆系统？
开始使用 代码 AI 记忆系统，建议先掌握以下要点：规则文件（.cursorrules / CLAUDE.md）：静态约定，始终加载。
代码 AI 记忆系统 的常见误区有哪些？
使用 代码 AI 记忆系统 时常遇到的问题包括：错误：智能体在同一工具调用上死循环 → 加最大迭代守卫和最近 N 步动作去重检查。；Error: Cannot find module '@modelcontextprotocol/sdk' → `npm install @modelcontextprotocol/sdk`；智能体需 SDK 调用 MCP 工具。；错误："Tool timed out after 30000ms" → 调大超时配置或将任务拆成智能体可增量完成的小子任务。。
代码 AI 记忆系统 的最佳实践是什么？
代码 AI 记忆系统 的最佳实践包括：规则短且权威；历史放 MEMORY.md。；每条记忆加日期以便按龄修剪。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习代码 AI 记忆系统？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。