为什么每次切换 AI 编程助手,记忆就清零?agentic-stack 用一套可移植大脑,让知识跨 Claude Code、Cursor 无缝迁移
【免费下载链接】agentic-stackOne brain, many harnesses. Portable .agent/ folder (memory + skills + protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, or DIY Python — and keeps its knowledge when you switch.项目地址: https://gitcode.com/gh_mirrors/ag/agentic-stack
agentic-stack是一个开源的「可移植大脑」方案:它把 AI 编程助手的记忆、技能、协议统一放进项目里的一个.agent/文件夹,让你从 Claude Code 换到 Cursor、Windsurf 或 Codex 时,助手积累的知识、偏好和经验教训原封不动地带走,而不是从零开始。
一、记忆清零的真相:大脑被锁在了每个工具里
用 AI 编程助手最痛苦的场景,大概是这个:
- 在 Claude Code 里用了三个月,它学会了你的提交规范、踩坑教训、项目架构;
- 某天团队改用 Cursor 或 Codex,新工具完全不认识这些积累;
- 你只能重新口述一遍偏好、重新演示一遍工作流——而且下次换工具,再来一遍。
根本原因在于:每个工具的记忆都存在自己的私有位置。Claude Code 写CLAUDE.md,Cursor 写.cursor/rules/*.mdc,Windsurf 写.windsurf/rules/,Codex 用AGENTS.md……它们之间互不认账,知识自然无法迁移。
agentic-stack 架构文档 把这个问题总结成一句话:"harness is dumb"——工具(harness)应该是笨的,知识、遥测和可复用资产应该沉淀在本地文件里。
二、agentic-stack 是什么:一个可移植的 .agent/ 文件夹
agentic-stack 的思路是反过来的:
大脑是可移植的,只有「胶水」会变。
它在你的项目里安装一个.agent/文件夹(即"大脑"),里面包含四层记忆、九个种子技能、权限协议和全套工具脚本。各 AI 助手只需通过一个薄薄的**适配器(adapter)**去读同一个大脑:
- 换 Claude Code → 适配器生成
CLAUDE.md+ hooks - 换 Cursor → 适配器生成
.cursor/rules/agentic-stack.mdc - 换 Windsurf → 适配器生成
.windsurf/rules/agentic-stack.md
也就是说,工具随便换,.agent/文件夹纹丝不动,记忆自然跟着走。
三、大脑里有什么:四层记忆 + 技能 + 协议
这套可移植大脑的结构在 docs/architecture.md 中有完整说明,核心是五块:
| 模块 | 作用 |
|---|---|
| 🧠四层记忆 | working/(当前任务)、episodic/(历史事件)、semantic/(提炼出的经验教训)、personal/(你的个人偏好) |
| 🛠️技能(Skills) | 按需加载的SKILL.md,只在任务匹配时进入上下文,不占额外 token |
| 🔒协议(Protocols) | 权限清单 + 工具 schema + 子代理委托规则,换工具也不变 |
| 📊数据层(Data layer) | 本地仪表盘:跨助手的活动、token/成本估算、KPI 日报 |
| 🔄数据飞轮(Flywheel) | 把人工批准的运行记录导出为轨迹、评测用例、训练就绪 JSONL |
其中personal/PREFERENCES.md是助手每次会话第一个读的文件——你的称呼、语言、解释风格、测试策略、提交规范都写在里面。这正是「记忆清零」的反面:换个工具,它开口第一句就知道该怎么跟你说话。
四、一键安装:最快上手步骤
上手只需要三步(详见 docs/getting-started.md):
1️⃣ 获取 agentic-stack(macOS / Linux / git-bash):
git clone https://gitcode.com/gh_mirrors/ag/agentic-stack cd agentic-stack ./install.sh claude-code /path/to/your-project2️⃣ 跟随引导向导:安装后自动打开 onboarding 向导,回答 6 个可跳过的问题(称呼、语言、解释风格、测试策略等),答案直接写入PREFERENCES.md。
3️⃣ 再装一个 Cursor,大脑自动共享:
./install.sh add cursor /path/to/your-project同一个仓库里,Claude Code 和 Cursor 现在共用同一个.agent/大脑——这就是"无缝迁移"最直观的样子。每个适配器的细节可在 adapters/ 目录下查阅,例如 adapters/cursor/README.md、adapters/claude-code/README.md。
五、跨工具迁移记忆:transfer 向导
如果记忆已经在一个项目里积累了一段时间,想搬到 Codex、Cursor、Windsurf 或纯终端环境,agentic-stack 提供了迁移向导(设计说明见 docs/superpowers/specs/2026-05-02-transfer-tui-wizard-design.md):
./install.sh transfer向导的工作方式对新手非常友好:
- 用自然语言描述意图,例如"把我的偏好和教训迁移到 Codex";
- 向导解析出目标工具和迁移范围(偏好、已接受的经验教训、技能、工作记忆、历史日志),供你逐项确认;
- 导出前自动做隐私检查:拦截疑似密钥的敏感内容,打包后附 SHA-256 校验;
- 生成一行 curl 命令,下一台机器/另一个项目直接导入,解包、校验、合并,一步到位。
整个过程无需手写任何 JSON 或复制任何文件,也不触碰各工具私有的记忆目录——只搬运.agent/里的可移植部分。
六、知识如何持续增长:夜间复盘循环
记忆可迁移只是基础,agentic-stack 还让大脑越用越聪明:
- 技能把每次操作写入 episodic 记忆;
- 夜间
auto_dream.py自动聚类重复模式,生成"候选经验"(只暂存,不自动接受); - 你或宿主助手用 harness_manager/ 配套的工具审查候选——接受时必须写明理由;
- 被接受的教训进入
semantic/lessons.jsonl,成为所有工具的共享知识库; - 未来每次会话,助手会按查询相关性自动召回这些教训。
也就是说:在 Cursor 里踩的坑,第二天 Claude Code 就知道该绕着走。
七、支持的 AI 编程助手一览
agentic-stack 内置 13 个适配器,覆盖主流工具(完整清单见 README.md):
| 工具 | 读取的配置 |
|---|---|
| Claude Code | CLAUDE.md+.claude/settings.json |
| Cursor | .cursor/rules/*.mdc |
| Windsurf | .windsurf/rules/*.md |
| OpenCode / OpenClaw / Hermes / Pi / Codex | AGENTS.md+ 各自 skills 目录 |
| Copilot CLI | AGENTS.md+.github/instructions/ |
| Gemini CLI / Antigravity | gemini.md/ANTIGRAVITY.md |
| 自建 Python 循环 | adapters/standalone-python/run.py |
装好后用./install.sh status一屏查看已接入的适配器和大脑状态,./install.sh doctor做只读健康审计。
八、总结:把记忆从工具里解放出来
回到开头的问题——为什么每次切换 AI 编程助手,记忆就清零?因为记忆一直存在工具私有的角落。
agentic-stack 的答案是:把大脑和工具解耦。一个可移植的.agent/文件夹承载记忆、技能与协议,13 个适配器负责"胶水"。换工具时:
- ✅ 偏好(PREFERENCES.md)跟走
- ✅ 经验教训(lessons)跟走
- ✅ 技能(skills)跟走
- ✅ 数据层仪表盘与飞轮产物跟走
- ❌ 只有适配器配置文件会变
如果你的工作流横跨多个 AI 编程助手,这套"一套大脑、多个外壳"的方案值得纳入工具箱。
📎 延伸阅读:docs/architecture.md(架构)、docs/getting-started.md(入门)、CHANGELOG.md(版本历史)、docs/data-layer.md(数据层)
【免费下载链接】agentic-stackOne brain, many harnesses. Portable .agent/ folder (memory + skills + protocols) that plugs into Claude Code, Cursor, Windsurf, OpenCode, OpenClaw, Hermes, or DIY Python — and keeps its knowledge when you switch.项目地址: https://gitcode.com/gh_mirrors/ag/agentic-stack
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考