用途:Tiered Agent Memory 用于减少 Squad 智能体每次 spawn 时无限制增长的上下文加载,将记忆分为热、冷、维基三层,让智能体只加载与当前任务相关的字节,旧上下文按需获取。
三层结构:热层为当前会话上下文(目标约 2–4KB),始终加载,内容含当前任务、本次会话决策、即时阻塞、最近 3–5 个动作、当前对话对象,会话结束丢弃;冷层为跨会话压缩历史(约 8–12KB),按需加载,含 Scribe 压缩的过去会话摘要、跨会话决策、反复出现的模式与未解决问题,滚动窗口默认 30 天,之后可提升至维基层;维基层为持久结构化知识,异步写入、选择性读取,含架构决策(ADR)、智能体章程、路由规则、稳定约定、外部 API 契约与平台约束,永久保留直至显式废弃。
加载策略:新任务无历史时仅热层;恢复中断工作或调试反复出现的问题时加载热+冷;按规范/ADR 实现或熟悉陌生子系统时加载热+维基;事故复盘时三者全加载。spawn 模板默认只含热层,需要历史时传 --include-cold,需要领域知识时传 --include-wiki,或在模板中引用 .squad/memory/cold/{agent-name}.md 与 .squad/memory/wiki/{topic}.md。
限制(v0.10.0):本技能描述的是设计提案而非已发布运行时。技能文件可通过 squad init/upgrade 安装,但底层分层脚手架(.squad/memory/hot/、cold/、wiki/)、Scribe 提升逻辑及 spawn 模板的分层读取仍在 bradygaster/squad#1264 中跟踪。在这些落地之前,智能体仍会在每次 spawn 时加载完整的 history.md 与 decisions.md。Scribe 作为记忆协调者的行为(会话结束时将热层压缩为冷层摘要、将老化的冷条目提升为维基、按需写入维基)也尚未实现。如需当前行为,见 .squad/agents/scribe/charter.md。相关跟踪:bradygaster/squad#686(分层记忆实现计划)、#600(上下文负载增长)。