用途:为当前项目完成 Basic Memory 插件的配置。运行一段约 2-3 分钟的自适应访谈,然后写入配置;访谈结束并确认计划前不做任何写入。
前置检查:先调用 list_memory_projects 确认 Basic Memory MCP 服务器已连接。若工具不可用或报错,需先安装并连接:uv tool install basic-memory(或 pip install basic-memory),版本 >= 0.19.0;再用 claude mcp add basic-memory -- uvx basic-memory mcp 连接,然后重启会话,再次确认 list_memory_projects 成功后才开始访谈。
访谈要点:使用焦点(代码/研究/写作/知识记录/规划/混合),决定建议的目录结构;项目映射(已有项目则从 list_memory_projects 选择,否则用 create_memory_project 新建,本地默认路径 ~/basic-memory/<名称>/,云端需传入工作区选择器和 /<名称> 形式路径,并用云端连接的 MCP 服务器创建);云/团队(用 list_workspaces 判断,团队项目放入 secondaryProjects 供只读召回,每次会话只读前 6 个共享项目,可选共享目标写入 teamProjects);存放约定(已有笔记则学习其真实约定,新项目则建议 3-5 个可选顶层文件夹,不创建空文件夹);模式(会话检查点、决策、任务);活跃度(输出风格 basic-memory,默认启用);共享技能(默认安装)。
执行:植入 schemas(session.md、decision.md、task.md,已存在则跳过,用 write_note 写入,元数据走 metadata 参数以防云端损坏);安装共享技能 npx skills add basicmachines-co/basic-memory --path skills(若为源码仓库则跳过);写入 basicMemory 设置块(含 primaryProject、secondaryProjects、captureFolder、rememberFolder、recallTimeframe、preCompactCapture、placementConventions、teamProjects,以及可选的 outputStyle),写入团队或个人的 settings.json 并合并保留其他键;随后用 CLI 对 primaryProject 做 search-notes --type schema --page-size 5 冒烟测试,非空 secondaryProjects 时再测一个共享项目。
收尾:简述项目映射、植入与已存在的模式、约定为学习还是建议、冒烟测试结果与输出风格开关;启用输出风格时提示重启会话以激活主动捕获(召回与 PreCompact 检查点已生效)。限制:所有细节依赖 Basic Memory 与 Claude Code 环境;具体平台范围、收费与更多定价信息暂未提供。