Skill 方式通过指令文件定义调用规则，放在 Agent 项目中，教会 Agent 在合适的时机主动调用 API。Skill 不注册工具，而是通过自然语言指令引导 Agent 的行为——Agent 读取指令后，在对话中自行决定何时发起 HTTP 请求。
\n| 条件 | \n说明 | \n
|---|---|
| Agent 可执行命令 | \n编程类 Agent（Claude Code、OpenCode、Codex CLI 等）可在对话中调用 curl | \n
| 需要精细控制 | \n希望自定义 Retain / Recall / Reflect 的触发时机和行为规则，而非完全交给 Agent 自主决策 | \n
| 无 MCP 支持 | \nAgent 不支持 MCP 协议，或不希望通过 MCP 注册工具 | \n
Skill 与 MCP 并非互斥——MCP 提供结构化的工具调用能力，Skill 定义行为规则和触发时机。两者可以同时使用：通过 MCP 注册工具让 Agent 知道\"能做什么\"，通过 Skill 指令告诉 Agent \"什么时候做\"。
\nSKILL.md）curl 调用记忆服务 API复制并运行以下命令，一键完成 CLI 安装、配置文件创建和 Skill 文件部署：
\n\n1# ━━ 一键安装（CLI + 配置 + Skill 文件） ━━\n2\n3mkdir -p ~/.cloudmemory && cat > ~/.cloudmemory/config << 'EOF'\n4api_url = \"https://cloud.memory.bj.baidubce.com/api\"\n5api_key = <your-api-key>\n6EOF\n7chmod 600 ~/.cloudmemory/config && curl -fsSL https://cloud-memory.bj.bcebos.com/get-cli | bash\n8\n9# 然后为你的 Agent 安装 Skill 文件（参阅下方「分步配置」选择安装方式）如果需要按步骤安装，请根据你的 Agent 类型选择对应配置方式。
\n1. 安装 CLI 并创建配置：
\n\n1mkdir -p ~/.cloudmemory && cat > ~/.cloudmemory/config << 'EOF'\n2api_url = \"https://cloud.memory.bj.baidubce.com/api\"\n3api_key = <your-api-key>\n4EOF\n5chmod 600 ~/.cloudmemory/config && curl -fsSL https://cloud-memory.bj.bcebos.com/get-cli | bash2. 创建 Skill 文件：
\n\n1# 复制下方「Skill 模板」的完整内容，然后执行：\n2mkdir -p .claude/commands\n3cat > .claude/commands/cloud-memory.md << 'SKILLEOF'\n4# （在此粘贴 Skill 模板内容）\n5SKILLEOF1. 安装 CLI 并创建配置：
\n\n1mkdir -p ~/.cloudmemory && cat > ~/.cloudmemory/config << 'EOF'\n2api_url = \"https://cloud.memory.bj.baidubce.com/api\"\n3api_key = <your-api-key>\n4EOF\n5chmod 600 ~/.cloudmemory/config && curl -fsSL https://cloud-memory.bj.bcebos.com/get-cli | bash2. 将 Skill 内容添加到 Codex 指令：
\n将下方「Skill 模板」的完整内容追加到 ~/.codex/instructions.md 或项目级 instructions 文件中。
| Agent | \nSkill 文件路径 | \n
|---|---|
| OpenCode | \n.opencode/skills/memory-service/SKILL.md | \n
| 自建 Agent | \n参考其文档确认指令文件加载路径 | \n
以下模板可直接使用，替换占位符后写入 SKILL.md 即可。
1---\n2name: memory-service\n3description: Agent 记忆服务接入。在对话前检索相关记忆，在对话后存储重要信息，实现跨会话长期记忆。\n4---\n5\n6# Agent 记忆服务\n7\n8通过 API 接入百度 Agent 记忆服务，实现长期记忆能力。\n9\n10## 连接信息\n11\n12- API Base URL: `<YOUR_API_BASE_URL>`\n13- Bank ID: `<YOUR_BANK_ID>`\n14- API Key: 通过环境变量 `MEMORY_API_KEY` 读取，不硬编码在文件中\n15\n16## 调用方式\n17\n18所有请求使用 HTTP Bearer 认证，通用请求头：\n19\n20```\n21Authorization: Bearer $MEMORY_API_KEY\n22Content-Type: application/json\n23```\n24\n25### Recall（检索记忆）\n26\n27**何时调用：** 每次收到用户新问题时，在回答前先调用。\n28\n29```bash\n30curl -s -X POST <YOUR_API_BASE_URL>/recall \\\n31 -H "Authorization: Bearer $MEMORY_API_KEY" \\\n32 -H "Content-Type: application/json" \\\n33 -d '{"query": "<用户的提问或当前话题>", "bank_id": "<YOUR_BANK_ID>", "budget": "mid"}'\n34```\n35\n36将返回的 `results` 数组中的记忆文本作为上下文，辅助回答用户问题。\n37\n38### Retain（存储记忆）\n39\n40**何时调用：** 对话中出现以下信息时，在回复后调用：\n41- 用户分享了个人偏好、习惯或背景\n42- 做出了重要决策或表达了明确观点\n43- 涉及项目、技术栈或业务关键信息\n44- 需要跨会话记住的事实或约定\n45\n46```bash\n47curl -s -X POST <YOUR_API_BASE_URL>/memories/retain \\\n48 -H "Authorization: Bearer $MEMORY_API_KEY" \\\n49 -H "Content-Type: application/json" \\\n50 -d '{"content": "<需要记忆的内容，用自然语言完整描述>", "bank_id": "<YOUR_BANK_ID>", "tags": ["user:<用户标识>", "topic:<话题>"]}'\n51```\n52\n53### Reflect（反思推理）\n54\n55**何时调用：** 需要对历史记忆进行综合判断、趋势分析或生成总结时调用，而非仅检索事实。\n56\n57```bash\n58curl -s -X POST <YOUR_API_BASE_URL>/reflect \\\n59 -H "Authorization: Bearer $MEMORY_API_KEY" \\\n60 -H "Content-Type: application/json" \\\n61 -d '{"query": "<需要反思的问题>", "bank_id": "<YOUR_BANK_ID>", "budget": "mid"}'\n62```\n63\n64## 行为规则\n65\n661. **先检索后回答**：收到用户消息后，先 Recall 检索相关记忆，再结合检索结果回答\n672. **主动存储**：识别到值得长期记住的信息时，主动 Retain，无需用户明确要求\n683. **使用 Tags 隔离**：Retain 时始终携带 `user:` 和 `topic:` 标签，Recall 时携带对应标签以精确匹配\n694. **自然语言描述**：Retain 的 content 使用完整的自然语言，保留人物、时间、原因等上下文\n705. **Document ID**：同一会话的所有 Retain 使用相同的 `document_id`，便于后续更新和删除\n716. **避免敏感信息**：不要将密码、密钥等敏感数据写入记忆user:alice、project:atlas），确保 Retain 和 Recall 使用一致的标签体系