Knowledge MEMO — Claude Code / Codex 的个人知识管理系统

> 一句话版本:一套 Claude Code / Codex 的 skill 集合,把 Karpathy 的 LLM Wiki 理念落地为可安装的工具——6 个命令覆盖阅读、笔记、间隔复习、查询和健康检查,用 Obsidian 做存储,强调"人必须在 loop 里"。

项目信息
来源https://github.com/owenliang60-ship-it/knowledge-mgmt
作者owenliang60-ship-it
创建时间2026-02-20
Stars9Forks 2
语言Python + Markdown(Claude Code / Codex Skills)
许可证MIT
标签claude-code, fsrs, knowledge-management, spaced-repetition

核心内容

系统架构


┌──────────────────────────────────────────────┐
│ L1 Schema Layer (宪法)                        │
│ SCHEMA.md · AGENTS.md                         │
│ 三层架构 / 8 种 Card / 四维标签 / 权限矩阵      │
├──────────────────────────────────────────────┤
│ L2 Flywheel Layer (动作闭环)                    │
│ /read → /insights → /note → /review           │
│ (Ingest)                      (Retain)        │
├──────────────────────────────────────────────┤
│ L3 Governance Layer (治理)                     │
│ /query · /lint                                │
└──────────────────────────────────────────────┘
         ↓ all write to
        📓 Obsidian Vault

6 个 Skill 详解

Skill作用输出
`/read`深度阅读论文/文章结构化分析报告(论点拆解 + 方法论评估 + 批判性分析)
`/insights`提取商业洞察可执行洞察报告
`/note`**唯一写入通道**研究摘要 + 原子卡片(双提议机制)
`/review`FSRS-6 间隔复习AI 出题 + 评分 + 助记强化
`/query`知识查询基于 vault 内容回答,标注来源
`/lint`健康检查断链/孤岛/缺标签/库存统计报告

最核心的设计:/note 双提议机制

/note 是整个系统的唯一写入通道,所有其他 skill 只做对话不写 vault。

执行流程:

1. AI 回顾对话,生成研究摘要("地图")

2. 展示摘要给用户阅读

3. 同时提出两类建议

- Wikilink 建议:链接到已有 Card(AI 搜索 vault 找相关内容)

- Atomic Card 建议:从对话中提取值得复习的知识点

4. 用户逐条确认后,AI 才执行写入

这个设计强制"人必须在 loop 里"——AI 不能自动创建任何卡片。

FSRS-6 间隔复习(Karpathy 没写的第四步)

/review 实现了完整的 FSRS-6 算法(和 Anki 新版相同的 SRS 引擎),纯 Python 实现(~600 行,只用 stdlib):

AGENTS.md 的五条铁律(FATAL)

这是整个项目最精彩的部分——写给 AI 的"不要作恶"准则:

1. FATAL-001:禁止擅自重组文件结构(AI 的整理强迫症会毁掉用户的心智模型)

2. FATAL-002:删除必须归档,禁止直接删(信息不可逆)

3. FATAL-003:禁止强加分类体系(用户的逻辑比任何分类体系都重要)

4. FATAL-004:禁止破坏现有链接和标签(每个 wikilink 都是资产)

5. FATAL-005:结构性变更必须走审批流(SCAN → PLAN → CONFIRM → EXECUTE → VERIFY)

三层架构(对齐 Karpathy)

Karpathy 概念Knowledge MEMO 实现
Raw Sources`Clippings/` + Obsidian Web Clipper
The Wiki`Cards/` + 8 种 Card 类型 + Domain MOCs
The Schema`SCHEMA.md` + `AGENTS.md`
Ingest`/read` + `/insights` + `/note`(双提议)
Query`/query`
Lint`/lint`
**🆕 Retain**`/review` + FSRS-6(Karpathy 没写)

8 种 Card 类型

类型用途存储位置
`type/reading`阅读摘要`Cards/Reading/`
`type/research`深度研究`Cards/Research/`
`type/insight`对话洞察`Cards/Insights/`
`type/concept`概念定义`Cards/`
`type/comparison`跨来源对比`Cards/`
`type/atomic`原子卡片(用于复习)`Cards/`
`type/moc`MOC 索引`Cards/`
`type/health-report`Lint 报告`Cards/`

每张 Card 必须有四维标签type/ + domain/ + category/(可选)+ mastery/(可选)。

权限矩阵

操作权限
创建研究摘要AI 执行(/note 内)
创建原子卡片**用户选择**
新 Card 内加 wikilink**用户确认**
已有 Card 正文补链**用户确认**
MOC 添加新条目AI 自主
MOC 修改/删除已有条目**用户确认**
Clipping 移至已研究AI 自动
Lint 报告生成AI 自动
SCHEMA.md 修改双方讨论

哲学立场

作者明确提出与 Karpathy "维护成本趋近零"的分歧:

> 知识没有经过人的大脑,连信息都算不上——它与用户没有真实关系。

核心论点:

1. Toolkit, not idea file:给一个能跑的工具,不是一篇博文

2. Human must stay in the loop:不是 fallback,而是全部意义

3. Personal template, not universal product:必须 fork 改造

4. 第四步 Retain:间隔复习把知识从 Obsidian 推进大脑——唯一不会因 GPT-6 发布而贬值的版本

分析

优势

不足

与 Jay 的关联

评分

维度评分 (1-10)说明
创新性7LLM Wiki 落地 + FSRS-6 集成 + 人机权限设计,组合新颖
实用性7对 Claude Code / Codex + Obsidian 用户极实用,但生态窄
工程质量9SKILL.md 规范详尽、FSRS 纯 Python 实现、race-condition 处理、版本管理
哲学深度9"为谁积累知识"的论证、四点分歧、反自动化立场,罕见地有深度思考
可扩展性5强绑定 Obsidian CLI,迁移到其他平台需要重写
生态39 stars,个人项目,无社区
与 Jay 的关联8和 Jay 的知识库高度同构,FATAL 铁律和 FSRS 可直接借鉴
**总分****6.9**个人知识管理领域最完整的 LLM skill 实现,工程质量顶尖但生态太小