Integrations
Devin
AI Tool

Devin

Connect Devin-style engineering agents to Memaster through Skills, workflow scripts, or Remote HTTP MCP when available.

SkillsWorkflowMCP optional

Devin 这类异步工程 Agent 常常跨多个任务处理同一代码库。接入 Memaster 后,可以在任务开始前召回项目约定、历史修复和用户偏好,并在任务结束后沉淀已验证的实现结论。

Task memory跨任务保存实现决策、调试结论和验收方式。
Workflow first把检索和写入固化到任务开始、阻塞排查和完成总结阶段。
Safe by default通过 project、area、source 和 memory_type 控制召回边界。

推荐接入方式

  • Skills 接入 —— 复制 memaster-memory Skill 到 Devin 可读取的 skills 或 workflow 目录,并让 Agent 按 Skill 规则执行。
  • 脚本接入 —— 在任务前后显式运行 scripts/memaster_memory.py search/add
  • MCP 接入 —— 如果运行环境支持 Remote HTTP MCP,直接配置 https://api.memaster.cn/mcpX-API-Key;如果只支持 stdio,使用本地 bridge 转发到该 endpoint。
⚠️

不要把 MEMASTER_API_KEY 写入仓库。使用 .env.local、运行环境 secret 或 CI/Agent 的凭据管理能力。

MCP 可选配置

如果 Devin 运行环境支持 Remote HTTP MCP,可使用统一的托管 endpoint:

mcp.json
{
  "mcpServers": {
    "memaster": {
      "type": "http",
      "url": "https://api.memaster.cn/mcp",
      "headers": {
        "X-API-Key": "msk_xxx"
      }
    }
  }
}

只支持 stdio MCP 的运行环境需要本地 bridge 转发到 https://api.memaster.cn/mcp;不支持 MCP 时使用下面的 Skill / 脚本方式。

安装 Skill

获取 Skill

从 GitHub 仓库复制 skills/memaster-memory

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

配置环境变量

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

编辑 .env.local

MEMASTER_API_KEY=msk_xxx
MEMASTER_USER_ID=alice
MEMASTER_AGENT_ID=devin
MEMASTER_SOURCE=devin
MEMASTER_PROJECT=my-repo
MEMASTER_AREA=backend

验证脚本

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

推荐工作流

任务开始前

python3 .devin/skills/memaster-memory/scripts/memaster_memory.py search \
  --query "当前任务相关的项目规范、用户偏好和历史调试记录是什么?" \
  --top-k 5

任务阻塞时

python3 .devin/skills/memaster-memory/scripts/memaster_memory.py search \
  --query "这个错误或相似模块以前如何修复?" \
  --memory-type debug

任务完成后

python3 .devin/skills/memaster-memory/scripts/memaster_memory.py add \
  --title "修复支付回调状态覆盖" \
  --content "已验证:paid 订单不能被后续 TRADE_CLOSED 覆盖,状态更新只允许 pending 进入非 paid 终态。" \
  --memory-type debug \
  --project "my-repo" \
  --area "server/pricing" \
  --scope "payment-callback" \
  --tags "支付,回调,调试"

metadata 建议

字段示例说明
projectmemaster仓库或产品名
areaserver-golang/pricingDevin 正在修改的模块
sourcedevin记忆来源
memory_typedebug / implementation / deployment记忆类型
scopepayment-callback任务主题

故障排查

现象检查项
MEMASTER_API_KEY is required.env.local 是否存在,运行目录是否指向正确 Skill
检索为空MEMASTER_USER_IDMEMASTER_PROJECTMEMASTER_AREA 是否与写入一致
写入失败提示缺少 project/area.env.local 或 CLI 中提供 MEMASTER_PROJECTMEMASTER_AREA
召回范围过宽增加 --project--area--memory-type--tags 过滤

下一步