智忆入门:让 Agent 像老员工一样复用团队经验
AI Experience Cloud|把真实做过的事,沉淀成可被人和 AI 持续复用的经验。

一、智忆是什么
智忆(zhiyi.atbigapp.com)是巨人肩膀生态中的「经验基础设施」。
它解决的不是「再写一篇文档」,而是:
- 每次对话结束,Context 清空,同类 Bug / 方案反复踩坑
- Wiki、飞书文档为人阅读优化,Agent 取用时噪音大、缺少「为什么」和适用边界
- 架构决策、排障教训只存在于个人脑中,人走经验也走
智忆用 结构化经验卡(背景、观察、决策、行动、结果、适用条件)沉淀真实做过的事;人可以浏览确认,Cursor / Claude Code 等 Agent 也能在开工前按任务精准召回。
产品定位一句话:
让 Agent 像工作五年的老员工一样工作。
二、产品飞轮:采集 → 确认 → 召回 → 进化

| 步骤 | 名称 | 做什么 |
|---|---|---|
| 01 | 自动采集 | Agent 完成任务后提交记忆草稿,或从对话 / 改动中提炼经验 |
| 02 | 人工确认 | 负责人在 Web 端 Review 草稿,校验可信度后发布 |
| 03 | 智能召回 | 新任务开始前,Agent 按任务上下文 Recall 相关经验与决策 |
| 04 | 持续进化 | Feedback 驱动排序,失效经验可标记,越用越准 |
与传统社区(文章 + 点赞)不同,智忆强调:验证、采纳、失效标记,以及 MCP 一等公民接入——经验即 Context。
三、典型使用场景

场景 1:研发团队少踩「重复坑」
团队刚修过「PM2 热更新找不到进程」「OAuth 回调 404」这类问题。若不沉淀,下个迭代或新人仍会再踩一遍。
用智忆后:
- 修完问题,让 Agent 调用
memory_submit提交经验草稿 - 负责人在「草稿确认」核对观察 / 决策 / 行动后发布
- 下次同类任务开始前,Agent 先
memory_recall,带着历史解法动手
场景 2:个人开发者沉淀可复用实践
个人也可先跑通闭环:把「自己踩过的坑 + 最终做法」写成经验卡。下周做相似需求时,Agent 不再从零猜,而是先读你的历史经验。
适合:已在用 Cursor / Claude Code,希望个人最佳实践不被对话窗口冲掉。
场景 3:把「为什么这样做」留下来(决策与规则)
记忆中心不只存经验,还可沉淀:
| 类型 | 记什么 | 何时用 |
|---|---|---|
| 经验 (Experience) | 可复用的做事方法(现象 → 方案 → 结果) | 排障、实现同类功能 |
| 规则 / 流程 | 长期要遵守的约定 | 代码规范、发版检查清单 |
| 决策 (Decision) | 为什么选了这条路的关键取舍 | 架构选型、技术债权衡 |
新人问「为什么不用方案 B」时,不再只靠口述,Agent 也能召回当时的决策上下文。
场景 4:组织记忆不随人走
骨干离职前,把关键排障经验、上线教训、模块约定确认入库。后续 Agent 与同事共享同一套 Memory,而不是从聊天记录里考古。
四、简单使用教程(约 15 分钟跑通闭环)

准备:Node.js 18+、Cursor(或其他支持 MCP 的 Agent)、巨人肩膀账号。
产品入口:https://zhiyi.atbigapp.com/
第 1 步:登录并签发 Agent 密钥
- 打开智忆,使用巨人肩膀统一账号登录(已有账号无需再注册)
- 进入工作台 → 打开工作空间设置
- 在 Agent API Key 中点击「签发密钥」
- 勾选权限:召回经验、提交草稿
- 立刻复制明文密钥(仅显示一次),妥善保存
第 2 步:在 Cursor 中配置智忆 MCP
在 Cursor 的 MCP 配置(如 .cursor/mcp.json 或全局 MCP 设置)中加入:
json
{
"mcpServers": {
"zhiyi-mcp": {
"command": "npx",
"args": ["-y", "zhiyi-mcp"],
"env": {
"BIGAPP_API_KEY": "粘贴你在工作空间签发的密钥"
}
}
}
}
说明:
- 把
BIGAPP_API_KEY换成上一步复制的密钥 - 生产包已内置 API 地址,一般只需填密钥
- 配置后重载 MCP,确认
zhiyi-mcp已连接
第 3 步:验证连通
在 Agent 对话中发送:
text
请调用智忆 MCP 工具 memory_recall,测试智忆是否已连通。
【必须执行】
1. 使用 MCP 工具 memory_recall(不要猜测或模拟返回)
2. task 填:MCP 连接测试
调用成功后,请告诉我:是否成功、返回了几条经验(可以为 0)、若失败请贴出报错。
能正常返回(哪怕 0 条)即表示接入成功。
第 4 步:完成一件真实事后,提交经验草稿
选一件刚做完的事(修 Bug、加页面、排查环境问题均可),对 Agent 说:
text
请调用智忆 MCP 工具 memory_submit,把刚才完成的任务提交为记忆草稿。
【必须执行】
1. 使用 MCP 工具 memory_submit 提交(不要只在聊天里总结)
2. knowledgeType 填 experience
3. payload 各字段分开写:
- task:任务标题(80 字以内)
- observation:遇到了什么问题/现象
- decision:为什么选这个方案
- action:具体改了哪些文件、配置或命令
- outcome:结果如何、怎样验证已解决
4. 如有改动过的文件,传入 modifiedFiles 数组
提交成功后会得到草稿 ID,状态为待确认(pending_review)。
若 Agent 只总结不调工具,可补充一句:「请立即调用 memory_submit MCP 工具提交」。
第 5 步:在 Web 端审核并发布
- 打开智忆 → 草稿确认 / Capture
- 核对标题与观察、决策、行动、结果,确认无敏感信息
- 确认发布到经验中心
质量不高可直接拒绝,不影响后续使用。
第 6 步:新任务前先召回
做同类任务前,先让 Agent 读经验再写代码:
text
请先调用智忆 MCP 工具 memory_recall 搜索团队历史经验,读完后再动手写代码。
【必须执行】
1. 使用 MCP 工具 memory_recall(不要用网页搜索,也不要凭记忆回答)
2. 将下方「任务描述」填入 task 参数(只写业务意图,不要把项目代号塞进 task)
3. 若已知当前文件或模块,一并传入 currentFile、module、repository
任务描述:【例如:修复登录页 OAuth 回调 404】
召回成功后请:列出最相关的 1~3 条经验标题,说明对当前任务的建议,再给出实施计划。
至此,「接入 → 沉淀 → 确认 → 召回」闭环已跑通。
五、日常怎么用更顺手
在 Web 端找历史方案
打开 经验搜索,用任务描述或关键词检索已发布经验,比翻聊天记录更直接,也可把命中内容整理后交给 Agent 继续用。
看经验有没有被真正用上
到 闭环追踪 查看取用、反馈与失效情况。长期无人采用或反馈不佳的,回到记忆中心修订或标记失效,让库越用越准。
经验 vs 社区帖子怎么选
| 社区帖子 | 智忆 | |
|---|---|---|
| 形态 | 全文文章 / 问答 | 结构化 Experience |
| 消费 | 人读全文 | 人浏览 + Agent 按任务 Recall |
| 质量信号 | 点赞、粉丝 | 验证、采纳、失效标记 |
| 适合目标 | 传播、讨论 | 团队与助手持续复用真实做过的事 |
目标若是「让团队和助手持续复用」,优先用智忆。
六、常用 MCP 工具一览
| 工具 | 作用 |
|---|---|
memory_recall |
按任务上下文召回已发布经验 |
memory_submit |
提交记忆草稿(经验 / 规则 / 流程 / 决策) |
memory_feedback |
对召回结果反馈(有用 / 过时 / 错误等) |
memory_graph_explore |
以某条经验为中心探索关系子图 |
召回时记住:task 只写业务意图;project / module / repository 用独立字段,避免项目名污染检索。
七、写在最后
智忆不是「AI 版知乎」,而是面向 人确认 + Agent 消费 的经验层:
- 先签发密钥并配置 MCP
- 用一件真实任务跑通提交与审核
- 下次同类任务先召回再动手
约 15 分钟,你就能拥有一条「可被人和 AI 共同复用」的组织记忆。
欢迎登录后从工作台「快速开始」跟着四步引导完成第一圈闭环。