cursor-evolution

让 Cursor AI 助手随项目迭代自动积累上下文的轻量框架。

解决什么问题

每次新会话，AI 都从零开始——不记得上次的技术决策、不知道项目里的陷阱、重复犯同样的错。

cursor-evolution 通过三个机制解决：

• memory.md：AI 自动记录隐性知识（决策推理、陷阱、反模式），新会话自动读取
• 习惯观察：AI 学习你的代码风格和工作流偏好，积累后提炼为规则
• /cursor-sync：定期从会话中提取知识、检查规则健康、整理 memory

快速开始

# 克隆仓库
git clone <repo-url> ~/program/cursor-evolution

# 在项目中初始化
~/program/cursor-evolution/init.sh /path/to/your/project

# 或者用绝对路径
./init.sh ~/program/my-awesome-project

初始化后，你的项目会多出：

.cursor/
├── rules/
│   ├── cursor-evolution.mdc   # 演化机制（AI 按需加载）
│   └── README.md              # 规则索引
├── commands/
│   └── cursor-sync.md         # 知识同步命令
└── memory.md                  # AI 知识记录（自动维护）

日常使用

你什么都不用主动做

• AI 自动观察你的偏好并记录到 memory.md
• 新会话涉及开发任务时，AI 自动读取 memory.md 获取上下文
• 规则按文件路径自动加载

偶尔做一件事：/cursor-sync

在以下情况运行：

• 完成大功能或排查复杂 bug 后
• AI 主动提醒时
• 感觉 AI 忘了之前讨论的事情时

添加项目特定规则

在 .cursor/rules/ 中创建 .mdc 文件：

---
alwaysApply: false
globs:
  - "src/backend/**"
---

# 后端开发规范

## 技术栈
- Express + TypeScript
- MongoDB

## 核心约定
- ...

然后更新 .cursor/rules/README.md 索引。

设计原则

1. 最小预加载：只有核心规则 alwaysApply，其他按需加载
2. 大小约束：memory.md 上限 100 行，超限时提炼或删除
3. 代码是真相：规则和文档都可能过时，AI 应以代码为准
4. 自动运转：习惯观察和冷启动不需要用户参与
5. 修改需确认：规则文件的修改必须用户确认

文件说明

文件	用途	AI 行为
cursor-evolution.mdc	定义演化机制	涉及规则维护时加载
cursor-sync.md	定义同步流程	/cursor-sync 命令触发
memory.md	存储隐性知识	自动读写，上限 100 行
README.md	规则索引	人工维护

与 OpenSpec 的关系

cursor-evolution 管理"怎么做"（技术约束、习惯），OpenSpec 管理"做什么"（功能规范）。两者独立使用，也可以配合：

• 有 OpenSpec 的项目：/cursor-sync 会额外巡检 openspec/changes/ 的状态
• 没有 OpenSpec 的项目：正常使用，忽略 OpenSpec 相关部分

从 baixiaoyi 项目群实践中提炼

这套体系在百小医项目群（5 个项目、18 条规则、9 个月迭代）中验证，经历了：

• 25 天无人维护后的规则腐化和修复
• 从 6 个 alwaysApply 削减到 2 个的上下文优化
• memory.md 从 183 行膨胀到精简为 66 行的生命周期管理
• OpenSpec specs 从"当前真相"降级为"历史参考"的认知迭代