Squad 三层记忆体系详解让 AI Agent 记住项目规范、不再重复犯错的核心机制【免费下载链接】squadSquad: AI agent teams for any project项目地址: https://gitcode.com/gh_mirrors/squad4/squadAI Agent 有个通病每次会话都失忆。你昨天刚说永远用单引号今天它又写回双引号上周踩过的坑这周原样再踩一遍。SquadAI Agent Teams for any project用一套三层记忆体系解决了这个问题——技能层Skills、共享决策层decisions.md、个人历史层history.md让 Agent 团队跨会话沉淀知识记住项目规范不再重复犯错。上图Squad 官方文档站的全文搜索搜索 agent所有记忆相关的文档与技能说明都能秒级检索到。为什么 Agent 会反复犯同样的错问题不在模型能力而在上下文没沉淀每次 spawn启动一个 Agent它只能看到当前任务描述历史经验无处安放生产环境实测显示老 Agent 的上下文高达 74KB其中82%–96% 是旧噪音——过期的任务记录、已完结的对话白白消耗 token、拖慢启动甚至让 Agent 把过期信息当成当前事实没有记忆的地方规范只能靠人反复叮嘱always 单引号 这种话一天要讲三遍。Squad 的思路很直接把记忆按谁能读、读多久、多重要分成三层各自独立演进、按需加载。三层记忆体系一览Squad 的记忆全部以纯 Markdown 文件存放在.squad/目录下提交到 Git 即可随仓库携带整体结构如下层级文件位置谁可以读存什么 技能层 Skills.copilot/skills/{name}/SKILL.md全体 Agent可复用的怎么做技巧 共享决策层.squad/decisions.md全体 Agent团队规则、架构决策 个人历史层.squad/agents/{name}/history.md仅该 Agent个人领域积累第 1 层Skills —— 可迁移的手艺技能是可移植的技术型知识比如如何用 GitHub Actions 搭 CI、如何写 e2e 测试。它和决策的关键区别决策是项目策略我们用 PostgreSQL换一个项目就不成立技能是通用技法CI 这样配置带着训练好的团队换新仓库技能原样带走。技能分两类squad init时自带的 Starter 技能升级会被覆盖以及 Agent 在实际工作中总结出来的Earned 技能升级永远不动。每个 Earned 技能还有一个置信度生命周期Low第一次写→ Medium多次成功应用→ High久经考验只升不降。第 2 层decisions.md —— 全团队的共享大脑这是记忆体系的核心中枢。所有 Agent 开工前都会先读它里面存着编码风格、工具偏好、分支规范、别碰 legacy/ 目录这类约束。决策有三条入口Agent 工作中产出——写入.squad/decisions/inbox/{agent-name}-{slug}.md投递箱多人并行写互不冲突你的指令Directives——只要说出 always、never、from now on、remember to 这类信号词协调者就会自动捕获并写入投递箱Scribe 合并——由后文的 Scribe 定期把投递箱去重合并进decisions.md。当decisions.md膨胀后过期条目会被归档到.squad/decisions-archive.md保留但不再加载保证 Agent 读到的永远是精瘦的当前规范。第 3 层history.md —— 每个 Agent 的私人笔记每个 Agent 在.squad/agents/{name}/history.md拥有独立记忆只读自己的。Kane 把认证系统摸得门儿清Dallas 精通组件库互不干扰——这正是专精的来源。配套的**渐进式摘要Progressive Summarization**机制保证文件不过胖history.md超过约 12KB 时旧条目自动压缩进摘要区近期条目保留细节。上图Squad SDK 的 API 参考页由 TypeDoc 自动生成记忆体系相关的扩展点如记忆提供者、存储契约都可以在这里查到。进阶Hot / Cold / Wiki 分级记忆模型三层解决了存什么、谁读还有一个问题是**每次启动都全量加载太贵**。Squad 的 Tiered Memory 提案 给出了答案按温度分三级加载。层级目标大小加载策略装什么 Hot热层~2–4KB每次必载当前任务、本轮决策、最近 3–5 个动作、当前阻塞❄️ Cold冷层~8–12KB按需加载--include-coldScribe 压缩后的跨会话摘要30 天滚动窗口 Wiki温层可变选择读取--include-wikiADR、Agent 章程、稳定约定、API 契约等持久知识核心原则是**少加载而非多加载**新任务只带热层调试老问题才翻冷层对接架构规范才查温层。生产环境实测效果团队规模分级前分级后降幅8 个 Agent34KB 历史8,800 tokens/次4,400 tokens/次~50%14 个 Agent74KB 历史18,500 tokens/次8,300 tokens/次~55%这套模型以内置技能形式落地详细说明见 Tiered Memory 功能文档 和技能定义 SKILL.md。Scribe幕后守护三层记忆的档案管理员三层不会自己维护Squad 为此设了一个默认角色 ScribeScribe 章程职责极其克制会话结束——扫描热层记忆把有价值的条目压缩目标约 10% 篇幅追加进冷层冷层老化——超过 30 天且已结构化的条目决策、约定、契约晋升进 Wiki合并投递箱——只合并已接受的决策精确去重合并前先复读确认再删除源文件。Scribe 的性格设定是沉默且不可见——如果用户注意到它说明流程出了错。更进一步记忆治理提案 还为每条记忆写入定义了六类安全分级TRANSIENT/LOCAL/DECISION/POLICY/COPILOT_MEMORY/FORBIDDEN密钥、PII、原始日志等被明确拒之门外从机制上保证记下的都是值得记的。30 秒上手用指令教会团队规范无需改任何代码三句话就能让记忆体系开始工作Always use Prettier with single quotes and no semicolons From now on, all commit messages must follow Conventional Commits format Never use any type in TypeScript — always define explicit types说第一句信号词被捕获 → 写入投递箱 → Scribe 合并 → 下次所有 Agent 开工前自动读到。想查看或删除规则直接问 Show me the team directives 即可也可以手改decisons.md——它就是普通 Markdown。官方概念文档 Memory Knowledge 里有完整的信号词表和指令作用域说明。记忆文件都在哪想查什么去哪看团队规范与决策.squad/decisions.md某 Agent 的领域积累.squad/agents/{name}/history.md可复用技能库.copilot/skills/{name}/SKILL.md三层记忆设计文档docs/proposals/tiered-memory.mdScribe 角色职责templates/scribe-charter.md分级记忆技能定义templates/skills/tiered-memory/SKILL.md一个小技巧如果某个 Agent 反复犯同一个错先查decisions.md——多半是缺了对应的那条规范补上指令即可根治。总结三层结构Skills 存怎么做的技法、decisions.md存团队必须遵守的规矩、history.md存每个 Agent 的专精积累各司其职、按需可见分级加载Hot/Cold/Wiki 让每次启动只带真正相关的上下文token 消耗最多降 55%过期信息不再污染决策自动治理Scribe 默默完成压缩、晋升、去重与归档配合记忆分类的安全门禁记下的每一条都干净可靠零门槛全部是纯 Markdown 文件说 always / never 就能写入规范提交 Git 后知识随仓库流动。给团队几个会话的时间它们就会停止重复提问——因为该记住的已经记住了。【免费下载链接】squadSquad: AI agent teams for any project项目地址: https://gitcode.com/gh_mirrors/squad4/squad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考