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-memorySkill 到 Devin 可读取的 skills 或 workflow 目录,并让 Agent 按 Skill 规则执行。 - 脚本接入 —— 在任务前后显式运行
scripts/memaster_memory.py search/add。 - MCP 接入 —— 如果运行环境支持 Remote HTTP MCP,直接配置
https://api.memaster.cn/mcp和X-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 建议
| 字段 | 示例 | 说明 |
|---|---|---|
project | memaster | 仓库或产品名 |
area | server-golang/pricing | Devin 正在修改的模块 |
source | devin | 记忆来源 |
memory_type | debug / implementation / deployment | 记忆类型 |
scope | payment-callback | 任务主题 |
故障排查
| 现象 | 检查项 |
|---|---|
MEMASTER_API_KEY is required | .env.local 是否存在,运行目录是否指向正确 Skill |
| 检索为空 | MEMASTER_USER_ID、MEMASTER_PROJECT、MEMASTER_AREA 是否与写入一致 |
| 写入失败提示缺少 project/area | 在 .env.local 或 CLI 中提供 MEMASTER_PROJECT 与 MEMASTER_AREA |
| 召回范围过宽 | 增加 --project、--area、--memory-type 或 --tags 过滤 |