生产环境 Agent Skills：唤醒、搜索、保存的可复用工作流

Skills 是契约

MCP 暴露工具；Skills 告诉 Agent 何时、如何用。没有 Skill 时，模型把 memory_search 当作普通工具—— sporadic 调用，往往在上下文已经错了之后。

Engra 在 /docs/memory/skills 发布 Skills。在 IDE 中安装，让每位工程师共享同一套记忆剧本。

推荐会话剧本

1. 会话开始 — memory_wake_up，注入 L0+L1。 2. 用户换主题 — 对新 Topic 集群 memory_recall。 3. 窄事实问题 — 带明确 query 的 memory_search。 4. 用户陈述持久信息 — memory_save_atom 并传 memoryLibraryId、Scope、Topic。 5. 会话结束 — 可选 save_atom 记录本次决策。

关键护栏

切勿把密钥或明文凭证写入 Atom——存引用，运行时从 vault 拉取。

每次保存必须带 Topic 元数据。无 Topic 的 Atom 会成为污染 L3 搜索的孤儿 embedding。

在 Agent 遥测中记录 wake_up/recall/search 返回的 Atom ID。用户反馈错误答案时可回放注入了哪些记忆。

团队推广

在仓库中锁定 Skill 版本。Engra 更新工具 schema 时升级 Skill，并跑短验收对话：列库、唤醒、搜索、保存、列 Atom。

Cursor 搭配 Memory MCP 接入；无法跑 MCP 的 CI Agent 用 REST。