用途:把持久、有用的上下文写入全局上下文系统,供智能体后续调用。默认记忆根目录为 ~/.agent-global-context/。
主要能力与流程:定位记忆根目录;读取 config.yaml、index.md 及相关目标文件;将信息按 P0-P4 分类;检查是否敏感或高影响;为项目级记忆解析项目 id;尽量去重或更新已有条目;按需写入带元数据与理由的 Markdown 记忆项;当召回行为变化时更新 index.md;最后报告变更文件。
分类:P0 用户背景与身份级上下文写入 user/profile.md;P1 技术或协作偏好写入 user/preferences.md;P2 编码习惯或工程风格写入 user/coding-style.md;P3 项目或环境知识写入 environment/ 或 projects/<project-id>/;P4 当前任务状态写入项目 active.md 或 sessions/。
项目解析:项目级记忆优先使用显式用户绑定和 index.md 的 Project Map,其次 Git remote slug,再次当前目录 slug;为新项目或含义不明的项目 id 创建记忆前需询问用户。
去重与更新:追加前先扫描目标文件是否存在同义记忆,若新信息澄清或刷新同一事实、偏好、习惯或决策则更新已有条目,仅在信息不同时追加;新记忆替代旧记忆时,将旧记忆标记 status: superseded,必要时在新条目使用 supersedes。
置信度:confirmed 用于用户明确陈述或批准;observed 用于可靠文件、命令输出、配置或重复可见行为;inferred 用于智能体推导但未直接确认的上下文;tentative 用于薄弱、含糊或可能临时的上下文。
敏感门控:提交敏感上下文前需询问,绝不存储密钥、令牌、密码、私钥或恢复码。使用提示语:This may be sensitive long-term context. Should I write it to the global context, stage it for review, or skip it?
会话压缩:被要求压缩会话时,在 projects/<project-id>/sessions/ 下写入带日期的摘要,更新 projects/<project-id>/active.md,仅提升具有明确未来价值的持久 P0-P3 信息,不保存完整记录;P4 活动状态视为临时,移除已完成下一步行动,避免把过期阻塞带入无关任务。
记忆项模板包含 memory-id、type、priority、confidence、source、scope、status、created_at、updated_at 等字段,以及记忆内容与 Rationale。写入后需总结写了什么、哪个文件变更、是否有内容被暂存或跳过。
限制:资料未提供安装命令、收费、价格、平台或效果信息。