记忆库系统 v0.8

一种基于令牌优化的分层任务管理系统，利用 Cursor 2.0 命令实现高效的开发工作流。

graph TD
    Main["记忆库系统"] --> Commands["Cursor 2.0 命令"]
    Main --> Rules["分层规则加载"]
    Main --> Visual["可视化流程图"]
    Main --> Token["令牌优化"]
    Main --> Memory["记忆库文件"]
    
    Commands --> VAN["/van: 初始化"]
    Commands --> PLAN["/plan: 任务规划"]
    Commands --> CREATIVE["/creative: 设计"]
    Commands --> BUILD["/build: 实现"]
    Commands --> REFLECT["/reflect: 回顾"]
    Commands --> ARCHIVE["/archive: 文档化"]
    
    Memory --> Tasks["tasks.md"]
    Memory --> Active["activeContext.md"]
    Memory --> Progress["progress.md"]
    Memory --> Creative["creative/"]
    Memory --> Archive["archive/"]
    
    style Main fill:#4da6ff,stroke:#0066cc,color:white
    style Commands fill:#f8d486,stroke:#e8b84d,color:black
    style Rules fill:#80ffaa,stroke:#4dbb5f,color:black
    style Visual fill:#d9b3ff,stroke:#b366ff,color:black
    style Token fill:#ff9980,stroke:#ff5533,color:black
    style Memory fill:#f9d77e,stroke:#d9b95c,color:black

个人说明: 记忆库是我个人的兴趣项目，专为我在编码项目中的使用而开发。由于这是一个个人项目，我并未维护问题跟踪器或主动收集反馈。不过，如果您在使用这些规则时遇到问题，其一大优势在于可以直接请求 Cursor AI 修改或更新规则，以更好地适应您的特定工作流。该系统设计为可由 AI 自行调整，使您无需外部支持即可根据自身需求进行定制。

关于记忆库

记忆库是一种结构化的开发工作流系统，利用 Cursor 2.0 命令引导您完成开发过程的不同阶段。它采用分层规则加载架构，仅加载每个阶段所需的规则，从而优化令牌使用并提供量身定制的指导。

工作原理

版本 0.8 将自定义模式改为使用 Cursor 命令。记忆库通过六个专用命令协同工作，形成一个集成的工作流：

1. /van - 初始化项目、检测平台、确定任务复杂度
2. /plan - 根据复杂度级别创建详细的实施计划
3. /creative - 探索需要设计决策的组件的设计方案
4. /build - 系统地实施计划中的变更
5. /reflect - 回顾已完成的工作并记录经验教训
6. /archive - 创建全面的文档并更新记忆库

每个命令都会读取和更新共享的记忆库目录（memory-bank/），在整个工作流中保持持久的上下文。

令牌优化架构

版本 0.7 引入了显著的令牌优化改进：

• 分层规则加载：初始仅加载必要规则，并采用专门的惰性加载机制（令牌消耗减少约 70%）
• 渐进式文档化：实施随任务复杂度扩展的简洁模板
• 优化的命令过渡：在命令之间高效保存关键上下文
• 分级工作流：根据任务复杂度调整文档要求（等级 1–4）
• 惰性加载的专用规则：仅在需要时加载专用规则（例如架构设计与 UI/UX 设计）

有关所有优化方法的详细信息，请参阅 记忆库优化 文档。

基于命令的工作流系统

记忆库将开发转变为一个结构化的分阶段过程：

• 基于图的命令集成：命令是开发工作流中的相互连接节点
• 工作流推进：命令按逻辑顺序依次过渡（/van → /plan → /creative → /build → /reflect → /archive）
• 共享记忆：通过记忆库文件在命令间转移时保持持久状态
• 自适应行为：每个命令会根据项目复杂度级别调整其建议
• 渐进式规则加载：命令仅加载必要的规则，从而减少上下文窗口的使用

这种方法将开发从随意编码转变为一个协调一致的系统，各专用阶段协同工作。

CREATIVE 命令与 Claude 的“Think”工具

/creative 命令的概念基础源自 Anthropic 的 Claude “Think” 工具方法论，如其工程博客所述。版本 0.8 实现了一个优化版本，具有以下特点：

• 渐进式文档化，包含表格形式的选项比较
• “按需细化”方法，兼顾令牌效率
• 随复杂度级别扩展的结构化模板
• 为实施阶段高效保存上下文

有关记忆库如何实现这些原则的详细说明，请参阅 CREATIVE 模式与 Claude 的“Think”工具 文档。

主要特性

• Cursor 2.0 命令：原生集成 Cursor 的命令功能，无需额外设置
• 分层规则加载：仅加载必要规则，并采用专门的惰性加载机制
• 渐进式文档化：简洁的模板可根据任务复杂度扩展
• 统一上下文传递：通过记忆库文件在命令间高效保存上下文
• 命令专属可视化地图：清晰展示各个开发阶段的可视化内容
• 分级工作流：根据复杂度调整流程（等级 1–4）
• 平台感知命令：自动适应您的操作系统
• 记忆库集成：所有命令均从共享的记忆库文件中读取并更新

安装说明

先决条件

• Cursor 编辑器：需使用 2.0 版本或更高版本（命令功能）
• AI 模型：推荐使用 Claude 4 Sonnet 或 Claude 4 Opus 以获得最佳效果，尤其是对于 /creative 命令的“Think”工具方法论

第一步：获取文件

只需将此仓库克隆到您的项目目录中：

git clone https://github.com/vanzan01/cursor-memory-bank.git

替代方案（手动）

从 ZIP 文件解压后：

• 将 .cursor 文件夹复制到您的项目目录中（包含规则和命令）
• custom_modes 文件夹仅用于参考，非必需

注意：其他文档对记忆库运行并非必要，它们仅为说明性文件。您可以根据需要将其复制到名为 memory_bank_documents 的文件夹中。

第2步：使用命令

命令即开即用！ 无需额外设置。

1. 在 Cursor 聊天中输入 / 即可查看可用命令：

   • /van - 初始化与入口点
   • /plan - 任务规划
   • /creative - 设计决策
   • /build - 代码实现
   • /reflect - 任务反思
   • /archive - 任务归档

2. 从 /van 开始 初始化你的项目：

   /van 初始化添加用户认证功能的项目
   

3. 按照工作流进行操作 - 每个命令都会引导你进入下一步

详细命令文档请参阅 /.cursor/commands/README.md。

基本用法

快速入门

1. 使用 /van 初始化：

   /van 在应用中添加用户认证功能
   

   • 分析你的项目结构
   • 确定任务复杂度（1-4级）
   • 如有必要，创建记忆库结构
   • 引导至相应的下一步命令

2. 根据复杂度遵循工作流：

   1级（快速修复Bug）：

   /van → /build → /reflect → /archive
   

   2级（简单增强）：

   /van → /plan → /build → /reflect → /archive
   

   3-4级（功能/系统）：

   /van → /plan → /creative → /build → /reflect → /archive
   

命令参考

/van - 初始化与入口点

用途： 初始化记忆库，检测平台，确定任务复杂度，引导至相应的工作流。

用法：

/van [任务描述]

作用：

• 检测你的操作系统并调整命令
• 验证或创建记忆库结构
• 分析任务需求
• 确定复杂度等级（1-4）
• 更新 memory-bank/tasks.md 中的初始任务信息

下一步：

• 1级 → /build
• 2-4级 → /plan

/plan - 任务规划

用途： 根据复杂度等级制定详细的实施方案。

用法：

/plan

作用：

• 从 memory-bank/tasks.md 中读取任务要求
• 审查代码库结构
• 制定实施方案（根据复杂度）
• 进行技术验证（2-4级）
• 确定需要创意阶段的组件
• 更新 memory-bank/tasks.md 中的完整计划

下一步：

• 如果有创意阶段 → /creative
• 如果没有创意阶段 → /build

/creative - 设计决策

用途： 对标记的组件进行结构化的设计探索。

用法：

/creative

作用：

• 从 memory-bank/tasks.md 中读取需进行创意工作的组件
• 针对每个组件探索多种设计方案
• 分析每种方案的优缺点
• 选择并记录推荐方案
• 创建 memory-bank/creative/creative-[feature_name].md 文档
• 更新 memory-bank/tasks.md 中的设计决策

下一步：

• 所有创意阶段完成后 → /build

/build - 代码实现

用途： 按照计划和创意决策实施更改。

用法：

/build

作用：

• 从 memory-bank/tasks.md 中读取实施方案
• 读取创意阶段文档（3-4级）
• 系统地实施更改
• 测试实施结果
• 记录执行的命令及结果
• 更新 memory-bank/tasks.md 和 memory-bank/progress.md

下一步：

• 实施完成后 → /reflect

/reflect - 任务反思

用途： 对已完成的实施进行结构化的反思。

用法：

/reflect

作用：

• 回顾已完成的实施
• 与原始计划进行对比
• 记录成功之处
• 记录遇到的挑战
• 记录经验教训
• 记录流程和技术改进
• 创建 memory-bank/reflection/reflection-[task_id].md
• 更新 memory-bank/tasks.md 中的反思状态

下一步：

• 反思完成后 → /archive

/archive - 任务归档

用途： 创建全面的归档文档并更新记忆库。

用法：

/archive

作用：

• 读取反思文档和任务详情
• 创建全面的归档文档
• 归档创意阶段文档（3-4级）
• 更新 memory-bank/tasks.md 将任务标记为已完成
• 更新 memory-bank/progress.md 中的归档引用
• 重置 memory-bank/activeContext.md 以准备下一项任务
• 创建 memory-bank/archive/archive-[task_id].md

下一步：

• 归档完成后 → /van（开始下一项任务）

示例工作流

以下是一个完整的3级功能工作流示例：

# 第1步：初始化
/van 添加支持OAuth2的用户认证功能

# 第2步：规划（VAN会根据3级任务引导至PLAN）
/plan

# 第3步：探索OAuth集成的设计方案
/creative

# 第4步：实现该功能
/build

# 第5步：对实施进行反思
/reflect

# 第6步：归档已完成的任务
/archive

记忆库结构

所有记忆库文件都存储在 memory-bank/ 目录中：

graph LR
    subgraph "记忆库目录"
        Tasks["tasks.md<br>真相来源"]
        Active["activeContext.md<br>当前焦点"]
        Progress["progress.md<br>实施状态"]
        Brief["projectbrief.md<br>项目基础"]
        Creative["creative/<br>设计决策"]
        Reflect["reflection/<br>回顾文档"]
        Archive["archive/<br>已完成任务"]
    end
    
    style Tasks fill:#f9d77e,stroke:#d9b95c,stroke-width:3px,color:black
    style Active fill:#a8d5ff,stroke:#88b5e0,color:black
    style Progress fill:#c5e8b7,stroke:#a5c897,color:black
    style Brief fill:#d9b3ff,stroke:#b366ff,color:black
    style Creative fill:#f4b8c4,stroke:#d498a4,color:black
    style Reflect fill:#b3e6cc,stroke:#66c999,color:black
    style Archive fill:#ffd9b3,stroke:#ffb366,color:black

核心文件

• tasks.md：任务跟踪、检查清单和组件列表的核心真相来源
• activeContext.md：保持当前开发阶段的关注点
• progress.md：跟踪实施状态和观察结果
• projectbrief.md：项目的基石和背景
• productContext.md：产品特定的上下文和需求
• systemPatterns.md：系统模式和架构决策
• techContext.md：技术背景和技术栈

生成文件

• creative/creative-[feature_name].md：设计决策文档（3-4级）
• reflection/reflection-[task_id].md：反思文档
• archive/archive-[task_id].md：已完成任务的归档文档

渐进式规则加载

每个命令都实现了渐进式规则加载，以优化上下文使用：

1. 核心规则 - 始终首先加载

   • main.mdc - 系统基础
   • memory-bank-paths.mdc - 文件路径定义

2. 命令特定规则 - 根据命令加载

   • 可视化流程图（例如：van-mode-map.mdc）
   • 命令特定的工作流

3. 复杂度特定规则 - 根据任务复杂度加载

   • 1级：workflow-level1.mdc
   • 2级：workflow-level2.mdc、task-tracking-basic.mdc
   • 3级：workflow-level3.mdc、planning-comprehensive.mdc
   • 4级：workflow-level4.mdc、architectural-planning.mdc

4. 专用规则 - 仅在需要时惰性加载

   • 创意阶段类型（建筑、UI/UX、算法）
   • 高级验证规则
   • 平台特定的适配

这种方法相比一次性加载所有规则，可将初始令牌使用量减少约70%。

复杂度级别

Memory Bank 会根据任务复杂度调整其工作流：

1级：快速修复Bug

• 工作流：/van → /build → /reflect → /archive
• 特点：单个文件更改，针对性修复
• 文档：最少，专注于修复内容

2级：简单增强

• 工作流：/van → /plan → /build → /reflect → /archive
• 特点：涉及多个文件，需求明确
• 文档：基本计划、实施步骤

3级：中级功能

• 工作流：/van → /plan → /creative → /build → /reflect → /archive
• 特点：新增组件，需进行设计决策
• 文档：全面计划、创意阶段、详细反思

4级：复杂系统

• 工作流：/van → /plan → /creative → /build → /reflect → /archive
• 特点：包含多个子系统，需做出架构决策
• 文档：分阶段实施、架构图、全面归档

故障排除

命令未显示

• 验证 Cursor 版本：确保您使用的是 Cursor 2.0 或更高版本
• 检查文件位置：确保项目根目录下存在 .cursor/commands/ 目录
• 重启 Cursor：有时需要重启才能检测到新命令

命令无法正常工作

• 检查 Memory Bank：确认 memory-bank/ 目录是否存在
• 验证任务状态：查看 memory-bank/tasks.md 中当前的任务状态
• 回顾命令顺序：确保您遵循正确的工作流顺序
• 检查规则：确认 .cursor/rules/isolation_rules/ 目录存在

规则未加载

• 验证文件路径：确保规则文件位于 .cursor/rules/isolation_rules/
• 检查文件权限：确认文件具有可读权限
• 查看命令日志：检查命令试图加载哪些规则

Memory Bank 问题

• 文件缺失：运行 /van 初始化 Memory Bank 结构
• 状态损坏：检查 memory-bank/tasks.md 中的任务状态
• 文件冲突：回顾最近对 Memory Bank 文件的更改

旧版自定义模式（已弃用）

注意：自定义模式已被弃用，推荐使用 Cursor 2.0 的命令。如果您正在使用 Cursor 2.0+，请改用命令。自定义模式的设置说明位于 custom_modes/ 目录中，仅供参考。

如果您使用的是不支持命令的旧版 Cursor，请参阅 命令迁移指南，了解有关旧版自定义模式设置的信息。

版本信息

这是 Memory Bank 系统的 v0.8 版本。它在保持所有功能的同时，相比 v0.7-beta 引入了显著的令牌优化改进。有关更改的详细信息，请参阅 发布说明。

持续开发

Memory Bank 系统目前仍在积极开发和改进中。需要了解的关键点如下：

• 开发中：这是一个处于开发中的测试版，预计会定期更新、优化并添加新功能。
• 功能优化：模块化架构允许持续改进，而不会破坏现有功能。
• 旧版本可用：如果您更倾向于使用旧版本（v0.1-legacy）的稳定性，可以在当前版本成熟之前继续使用。
• 架构优势：在决定使用哪个版本之前，请阅读 Memory Bank 升级指南，以了解新架构带来的显著优势。

资源

• 命令文档 - 详细的命令使用指南
• 命令迁移指南 - 从自定义模式到命令的迁移
• Memory Bank 优化说明 - 关于令牌效率提升的详细概述
• 发布说明 - 最新更改的相关信息
• Memory Bank 升级指南 - 了解新架构
• CREATIVE 模式与 Claude 的“思考”工具 - 设计方法论说明

贡献

如上文个人说明所述，Memory Bank 是一个个人项目。然而，如果您觉得它有用并希望将其应用于自己的需求，您可以：

1. 咨询 Cursor AI：直接使用 Cursor AI 修改规则和命令
2. 分支并定制：克隆仓库并根据您的工作流进行调整
3. 分享改进：如果您做出了有用的改进，可以考虑与社区共享

---

注：此 README 适用于 v0.8 版本，并可能随系统演进而变化。

cursor-memory-bank 快速上手指南

cursor-memory-bank 是一个基于 Cursor 2.0 命令的层级化任务管理系统。它通过优化的令牌（Token）使用策略和分阶段的工作流（初始化、规划、设计、构建、反思、归档），帮助开发者高效管理开发流程并保持上下文连贯。

环境准备

在开始之前，请确保满足以下前置条件：

• 编辑器要求：必须安装 Cursor Editor 且版本为 2.0 或更高（需支持 Commands 功能）。
• 推荐模型：为了获得最佳体验（特别是 /creative 命令的“思考”功能），建议使用 Claude 4 Sonnet 或 Claude 4 Opus 模型。
• 网络环境：由于需要克隆 GitHub 仓库，建议配置好网络加速或使用国内镜像源。

安装步骤

只需将仓库文件复制到你的项目目录即可，无需复杂的配置。

方式一：使用 Git 克隆（推荐）

在项目根目录下执行以下命令：

git clone https://github.com/vanzan01/cursor-memory-bank.git

注意：克隆后，请确保将生成的 .cursor 文件夹移动到或直接保留在你的项目根目录下。如果克隆到了子文件夹，请将 .cursor 文件夹剪切至项目根部。

方式二：手动安装

1. 从 GitHub 下载仓库的 ZIP 包并解压。
2. 将解压后的 .cursor 文件夹复制到你的项目根目录中。
3. （可选）其他文档文件（如 README.md 等）仅用于参考，非运行必需，可按需整理到 memory_bank_documents 等文件夹中。

安装完成后，系统即可立即使用，无需额外初始化脚本。

基本使用

该系统通过 6 个专用命令引导你完成开发全流程。所有命令共享 memory-bank/ 目录下的上下文文件。

1. 启动工作流

在 Cursor 聊天窗口中输入 / 即可看到可用命令。始终从 /van 开始初始化任务。

示例：初始化一个添加用户认证功能的任务

/van Add user authentication to the application

执行后，系统会自动：

• 检测操作系统并适配命令。
• 分析任务复杂度（分为 Level 1-4）。
• 创建或更新 memory-bank/ 结构。
• 根据复杂度推荐下一步操作。

2. 遵循自动化工作流

系统会根据任务复杂度自动规划路径，你只需按提示依次执行命令：

• Level 1 (简单修复): /van → /build → /reflect → /archive

• Level 2 (常规增强): /van → /plan → /build → /reflect → /archive

• Level 3-4 (复杂功能/系统设计): /van → /plan → /creative → /build → /reflect → /archive

3. 完整操作示例

假设你要开发一个包含 OAuth2 支持的用户认证功能（通常为 Level 3 任务），操作流程如下：

# 1. 初始化任务
/van Add user authentication with OAuth2 support

# 2. 制定详细计划 (由 /van 自动路由)
/plan

# 3. 探索设计方案 (针对复杂组件)
/creative

# 4. 执行代码实现
/build

# 5. 复盘与反思
/reflect

# 6. 归档任务文档
/archive

每个命令执行完毕后，会更新 memory-bank/ 中的状态文件，并提示你下一个应执行的命令，直至任务归档完成。归档后，可再次使用 /van 开启新任务。