SuperAPI AI 工具集

memorizer

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

memorizer 是一个三层记忆系统,为当前任务提供上下文,并在任务完成后沉淀知识。

记忆层级:用户偏好存于 ~/.talos/profile.md,记录跨项目的编码风格与协作习惯,纯文本要点,不超过 50 行;项目热记忆存于 wiki/hot.md,记录关键约束、重大坑与强偏好,不超过 100 行;项目知识库存于 wiki/<category>/<name>.md,记录领域知识、可复用模式与技术选型,采用 Obsidian markdown([[wikilinks]]),容量不限。变更日志存于 wiki/log.md,按 ## [YYYY-MM-DD] 操作 与标题记录时间线。容量满时删除不重要的内容腾出空间。

读取记忆时依次读取 ~/.talos/profile.md、wiki/hot.md、wiki/INDEX.md(不存在则跳过),扫描索引全文定位与当前任务相关的条目,必要时深入读取对应的 wiki/<type>/<name>.md 页面,提取相关上下文供工作参考。

写入记忆需在完成较完整任务后显式判断,结论可以是“无需写入”。仅当满足以下条件之一才写入:非显而易见的架构决策或约束;发现的坑、反模式或踩过的雷;项目特定的可复用模式;用户明确表达的偏好或纠正;项目结构的关键变化;对已有知识的有价值分析或综合。写入后追加条目到 wiki/log.md。

INDEX.md 是知识库内容目录,每个条目包含链接、一行摘要和可选元数据,按语义类型分组:entities(具体的人、工具、库、系统)、concepts(抽象概念、模式、方法论、设计原则)、decisions(架构决策记录与技术选型理由)、sources(外部来源摘要)。新增、更新或删除知识库页面时需同步维护 INDEX.md。

不应记录的内容包括:合格开发者都知道的常规实现细节、可从代码或 git history 推断的内容、一次性调试细节、与项目无关的通用知识、没有 why 或教训的纯粹事实陈述。

Lint 为定期维护,在用户要求或间隔较久时检查知识库健康度,包括页面间矛盾、过期内容、孤立页面、INDEX.md 缺失或失效链接、多次提到但缺少独立页面的重要概念;发现问题时修复并追加 lint 条目到 wiki/log.md。