<< All versions

Skill v1.0.0

currentLLM-judged scan90/100
ob-labs/talos/memorizer
──Details
PublishedOctober 23, 2026 at 03:31 AM
Content Hashsha256:73098dc8b9950800...
Git SHAd2f748ec4ace
──Files
Files (1 file, 3.3 KB)
SKILL.md3.3 KBactive
SKILL.md · 83 lines · 3.3 KB

version: "1.0.0" name: memorizer description: > 三层记忆系统:读取用户偏好、项目热记忆和知识库为当前任务提供上下文; 任务完成后将有价值的知识沉淀回记忆。 user-invocable: true


三层记忆系统,为当前任务提供上下文并沉淀知识。

记忆层级

层文件内容格式容量
用户偏好~/.talos/profile.md跨项目的编码风格、协作习惯纯文本要点≤50 行
项目热记忆wiki/hot.md关键约束、重大坑、强偏好纯文本要点≤100 行
项目知识库wiki/<category>/<name>.md领域知识、可复用模式、技术选型Obsidian markdown([[wikilinks]])不限
变更日志wiki/log.md记忆变更的时间线记录`## [YYYY-MM-DD] 操作标题`append-only

满了删不重要的为新内容腾空间。

读取记忆

依次读取以下文件(不存在则跳过):

  1. ~/.talos/profile.md
  2. wiki/hot.md
  3. wiki/INDEX.md — 扫描索引全文,定位与当前任务相关的条目,必要时深入读取对应的 wiki/<type>/<name>.md 页面

提取与当前任务相关的上下文,在工作中参考。

写入记忆

完成较完整的任务后,显式判断是否需要写入记忆(结论可以是"无需写入")。只有满足以下条件之一才写入:

  • 涉及非显而易见的架构决策或约束(why 不直观)
  • 发现了坑 / 反模式 / 踩过的雷(其他人会再踩)
  • 项目特定的可复用模式(不是通用的最佳实践)
  • 用户明确表达的偏好或纠正
  • 项目结构的关键变化
  • 对 wiki 中已有知识的有价值分析或综合(查询回流)

写入后追加条目到 wiki/log.md。

INDEX.md 维护规则

wiki/INDEX.md 是知识库的内容目录。每个条目:链接 + 一行摘要 + 可选元数据(日期、来源数)。

索引按语义类型分组,每个类型对应 wiki 目录下的一个子目录:

类型目录内容
entitieswiki/entities/具体的人、工具、库、系统等实体
conceptswiki/concepts/抽象概念、模式、方法论、设计原则
decisionswiki/decisions/架构决策记录(ADR)和技术选型理由
sourceswiki/sources/文档、文章、论文等外部来源的摘要

写入/更新知识库页面时同步维护 INDEX.md:

  • 新增页面 → 在对应类型的分组下插入条目
  • 更新页面 → 更新摘要(如有变化)
  • 删除页面 → 移除对应条目

什么不该记

  • 合格开发者都知道的常规实现细节
  • 可从代码 / git history 推断的内容
  • 一次性的调试细节(除非揭示了系统性问题)
  • 与项目无关的通用知识
  • 纯粹的事实陈述(没有 why 或教训)

Lint(定期维护)

当用户要求或间隔较久时,检查知识库健康度:

  • 页面间是否存在矛盾(不同页面记录了冲突的信息)
  • 过期内容(已被代码变更推翻的结论)
  • 孤立页面(没有其他页面链接到它)
  • INDEX.md 中缺失的页面或指向已删除页面的链接
  • 多次提到但缺少独立页面的重要概念

发现问题时修复,并追加 lint 条目到 wiki/log.md。

All versions