SuperAPI AI 工具集

10x-labs-memory-atlas

编程与开发

查看项目

更新于 11-05 00:07

技能介绍

用途

该技能用于让编码代理把自己长期积累的“记忆”变得可见、可审计、可处置。代理在工作过程中会保存零散事实:用户偏好、项目约束、纠正意见等,分散在按项目、按用户甚至用户从未打开过的目录中。时间一长,用户难以知道代理持有哪些认知、哪些笔记已过时、哪些项目之间存在矛盾。本技能读取全部此类记忆,整理成排名行动计划,并写出以计划开头的记忆地图。

主要能力

第一步,揭示代理自身的记忆系统:说明记忆写入位置、格式、是否有索引文件、会话启动时加载哪些记忆、会话历史存放位置;在磁盘上逐一核实这些位置,并以会话历史中“实际加载了哪些记忆文件”的记录为准,因为记录优先于代理自述;再扫描可能遗漏的记忆类文件。

第二步,依据会话历史而非猜测,列出机器上所有与代理有过会话的项目,映射回真实项目路径,记录路径是否仍存在、会话数量与最后会话日期;同时将“从父目录启动、未加载项目记忆”的会话单独统计。

第三步,逐个项目读取记忆全文,记录路径、类型与最后修改日期,用一行概括每条记忆,保留其中“为什么”的理由。标记问题:陈旧(引用的文件、函数、分支或日期已不存在或已过期)、重复、冲突、孤儿(索引列了但文件缺失,或文件未被索引)、位置不当(项目事实存为全局记忆,或反之)。遇到令牌、密码、密钥或隐私数据时以 [redacted: 类型] 占位并标记,绝不复制原文。全程不编辑、合并或删除任何内容。

第四步,把问题归并成“用户实际会做的一件事”级别的修复,最多约十余项,按三档排序:立即处理(当前误导在线会话或知识丢失)、尽快处理(知识未触达需要它的会话、已完成工作仍被呈现为当前)、方便时处理(细节漂移、失效链接等小修正)。每项修复写明标题、原因、涉及的记忆、执行者(代理或需用户决策)以及可直接粘贴的提示词,提示词含确切路径与操作说明,删除前须询问。记忆按主题而非目录分组,给出 5–8 个主题与简短人类可读标题;并用脚本校验每条记忆恰好出现一次、每个被标记记忆都归入某项修复或明确无需处理。

使用方式与输出

在当前目录(或用户指定目录)的 memory-atlas/ 下写出两个文件并打印路径。memory-atlas.md 依次包含:结论句(多少条记忆、多少条无需处理、其余归结为多少项修复、多少项值得现在做)、分层计划、按主题组织的“代理知道什么”、记忆机制说明、扫描局限与项目表。memory-atlas.html 为同一内容的单文件,可在磁盘上直接打开:先呈现结论与分层拆解,计划卡片带复选框(用 localStorage 记住进度,存储被禁时仍可用)、复制提示词按钮(剪贴板 API 不可用时提供回退),记忆与提示词文本可折叠;随后是可折叠主题、搜索框、“仅显示需修复”开关的记忆地图;参考资料(记忆机制、项目表、扫描局限)最后折叠。仅用内联 CSS 与 JS,无 CDN、字体或网络请求,支持明暗模式与手机宽度,记忆文本以 textContent 插入或做 HTML 转义,嵌入页面的 JSON 中转义 <。若可渲染截图,应在完成前查看并修正;否则需说明未在浏览器中检查。除非用户要求,不上传或发布这两个文件。

适用场景与限制

适用于代理拥有持久记忆、用户希望了解其全部记忆内容并得到整治计划的场景。不处理用户手写的指令类文件(如 CLAUDE.md、AGENTS.md、规则文件等),这些属于用户可见范围;如果代理本身没有持久记忆,应两行说明而不生成空地图;如果用户只想修改某一条特定记忆,直接修改即可。