Agent Skills 开放标准
印格提供跨 Agent 通用的 SKILL.md,已验证 Cursor、Claude Code、OpenClaw、VS Code Copilot、Windsurf、Cline、OpenCode。配合 Memory MCP 为编码 Agent 注入长期记忆工作流。
集成版本 v1.9.0
- REST API
- v1.6.0
- MCP
- v1.9.0
- Agent Skill
- v1.9.0
- 记忆引擎
- v0.5.0
见 skills/engra-memory/SKILL.md frontmatter 中的 version 字段。
什么是 Agent Skill?
Agent Skill 遵循 Agent Skills 开放标准:YAML frontmatter(name、description)+ Markdown 指令正文。宿主根据 description 自动匹配并加载技能。同一份 SKILL.md 可在多种编码 Agent 间复用;印格记忆库还需在客户端配置 Memory MCP 才能调用 memory_search 等工具。
推荐接入(Skill + MCP)
| Agent | 个人 | 项目 |
|---|---|---|
| Cursor | ~/.cursor/skills/ | .cursor/skills/ |
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| OpenClaw | ~/.openclaw/skills/ | .openclaw/skills/ |
| VS Code + Copilot | — | .github/skills/ |
| Windsurf | ~/.windsurf/skills/ | .windsurf/skills/ |
| Cline | ~/.cline/skills/ | .cline/skills/ |
| OpenCode | ~/.config/opencode/skills/ | .opencode/skills/ |
仓库内 skills/engra-memory/SKILL.md 为官方技能包,复制整个 engra-memory 目录到上表对应路径即可。MCP 配置方式见记忆库 MCP 文档。
skills/engra-memory/SKILL.md
更多 SKILL.md 兼容工具
以下工具同样支持 Agent Skills 标准格式,可直接复用 skills/engra-memory/SKILL.md;MCP 接入方式因客户端而异,需参考各工具文档配置 Streamable HTTP 端点:OpenAI Codex CLI(~/.codex/skills/)、Gemini CLI、Roo Code、Goose、Amp、JetBrains Junie 等。完整兼容列表见 agentskills.io。
安装步骤
- 在控制台创建 API Key(/dashboard/keys),勾选 memory:read,写入场景另勾 memory:write
- 将 MCP 配置写入客户端(见下方示例或 skills/engra-memory/mcp.example.json)
- 复制 skills/engra-memory/ 到本机或项目的 Agent skills 目录
- 重启 Agent 或重新加载 skills,确认 MCP 工具 memory_list_libraries 可用
- 新会话开始时 Agent 应能按技能指引调用 memory_wake_up / memory_search
MCP 配置(Skill 前置依赖)
Skill 描述的是「如何使用记忆工具」;实际工具由 Memory MCP 提供。两者需同时配置:MCP 负责连接,Skill 负责工作流与触发时机。
{
"mcpServers": {
"engra-memory": {
"url": "https://mcp.engra.ai/api/v1/memory/mcp",
"headers": {
"Authorization": "Bearer inf_xxxxxxxx",
"Accept": "application/json, text/event-stream",
"Content-Type": "application/json"
}
}
}
}OpenClaw / Claude 插件包布局
OpenClaw 可原生加载 Claude 格式插件包:skills/ 目录作为技能根,.mcp.json 合并进嵌入式 MCP 设置。可将印格技能与 MCP 配置打包为团队分发包。
your-team-bundle/ ├── skills/engra-memory/SKILL.md ├── skills/engra-memory/TAXONOMY.md └── .mcp.json
技能内推荐工作流
- memory_list_libraries → 获取 memoryLibraryId(敏感域用独立库)
- 新会话 → memory_wake_up(传入用户首条消息)
- 需要历史上下文 → memory_search / memory_recall
- 出现可跨会话复用的知识 → 主动 memory_save_atom(一事实一 Atom;正文自洽;先 search 去重;填 scope/topic)
- 检索命中过时内容 → memory_correct_atom(勿对同一事实重复 save;保留 revisions)
- 写工具默认异步(202 + job.id):快速返回、后台落盘;勿指望立刻 search 命中
- 任务完成或会话结束前 → 落盘本次决策与教训
OpenClaw 特别说明
- Claude commands/ 与 Cursor .cursor/commands/ 会被 OpenClaw 映射为额外 skill 根
- 从 Claude 迁移时,带 SKILL.md 的技能会复制到 OpenClaw workspace skills 目录
- Claude 命令导入后默认 disable-model-invocation: true,需手动改 frontmatter 以允许自动调用
- 详见 OpenClaw 文档:Plugin bundles 与 Migrating from Claude