AI Tool

CodeBuddy

Connect CodeBuddy to Memaster with a portable memory Skill and local scripts.

SkillsRulesSDK / RESTMCP optional

CodeBuddy 可以通过本地 Skill 或规则文件把 Memaster 作为长期记忆层。适合保存用户协作偏好、项目事实、调试结论和团队工程规范。

Portable skill同一份 memaster-memory Skill 可在 CodeBuddy、Devin、Cursor、Claude Code 中复用。

Script-backed通过 Python helper 调用 Memaster API，不要求 MCP。

Structured memory强制 project、area、scope 和 tags，便于后续过滤召回。

MCP 可选配置

如果当前 CodeBuddy 版本支持 Remote HTTP MCP，可以直接把 Memaster 托管 endpoint 加入 ~/.codebuddy/mcp.json：

~/.codebuddy/mcp.json

{
  "mcpServers": {
    "memaster": {
      "type": "http",
      "url": "https://api.memaster.cn/mcp",
      "headers": {
        "X-API-Key": "msk_xxx"
      },
      "description": "Memaster hosted memory tools"
    }
  }
}

⚠️

CodeBuddy 官方文档当前主要展示 stdio 示例。如果你的版本只支持 stdio MCP，请使用本地 bridge 转发到 https://api.memaster.cn/mcp，或继续使用下面的 Skills / Rules / 脚本接入方式。

安装

复制 Skill

cp -R skills/memaster-memory .codebuddy/skills/memaster-memory

创建 `.env.local`

cp .codebuddy/skills/memaster-memory/.env.example .codebuddy/skills/memaster-memory/.env.local

设置必要变量

MEMASTER_API_KEY=msk_xxx
MEMASTER_USER_ID=alice
MEMASTER_AGENT_ID=codebuddy
MEMASTER_SOURCE=codebuddy
MEMASTER_PROJECT=my-repo
MEMASTER_AREA=workspace

验证配置

python3 .codebuddy/skills/memaster-memory/scripts/memaster_memory.py doctor

Rules 模板

.codebuddy/rules/memaster-memory.md

复杂任务开始前，先调用 Memaster 检索用户偏好、项目事实和历史调试记录。
创建文件、修改核心抽象或调整接口前，再次检索相关实现模式。
任务完成后，只保存稳定、可复用、已验证且不包含敏感信息的结论。
写入记忆时附带 project、area、scope、source、memory_type 和 tags。
不要保存 API Key、Token、私钥、密码或 `.env` 真实值。

常用命令

python3 .codebuddy/skills/memaster-memory/scripts/memaster_memory.py search \
  --query "这个项目的代码风格和测试要求是什么？"
 
python3 .codebuddy/skills/memaster-memory/scripts/memaster_memory.py add \
  --title "项目测试要求" \
  --content "修改核心逻辑后需要运行对应模块测试和文档构建。" \
  --memory-type project_info \
  --tags "测试,规范,项目"

验证接入

python3 .codebuddy/skills/memaster-memory/scripts/memaster_memory.py add \
  --title "包管理器约定" \
  --content "这个项目默认使用 pnpm，不使用 npm。" \
  --memory-type project_info \
  --tags "包管理,规范"
 
python3 .codebuddy/skills/memaster-memory/scripts/memaster_memory.py search \
  --query "这个项目使用什么包管理器？"

故障排查

现象	检查项
读取不到 `.env.local`	脚本路径是否来自 `.codebuddy/skills/memaster-memory`
401	API Key 是否有效，是否使用 `X-API-Key`
写入缺少 metadata	设置 `MEMASTER_PROJECT` 和 `MEMASTER_AREA`
召回不相关	增加 project、area、source 和 tags 过滤

下一步

Skills 接入 Devin 接入 Cursor 接入

Codex GitHub Copilot