A
Astro-Han/karpathy-llm-wiki
Agent Skills-compatible LLM wiki for Claude Code, Cursor, and Codex. Build a Karpathy-style knowledge base from raw sources, citations, and linting.
agent-skillclaude-codecodexcursorkarpathyknowledge-baseknowledge-managementllmllm-wikimarkdownpersonal-knowledge-baseproductivityrag-alternative
MIT创建于 2026/4/5更新于 今天
README
由 Gemini 翻译整理
karpathy-llm-wiki
这是一个可复用的技能组件，支持使用 Claude Code、Cursor、Codex 及其他 Agent Skills 工具构建 Karpathy 风格的 LLM Wiki。
karpathy-llm-wiki 将 Karpathy 的 LLM Wiki 理念打包成了一个可安装的 Agent Skills 技能。你的编码 Agent 会将原始资料录入到 raw/ 目录，将沉淀的知识页面编译到 wiki/ 目录，通过引用来源回答问题，并对 Wiki 进行 Lint（代码/文档规范检查）以确保一致性。
什么是 LLM Wiki？
LLM Wiki 是一种知识系统，LLM 在其中维护结构化的 Wiki 页面，而不是在每次提问时都重新搜索原始文档。新的资源被编译成持久化的 Markdown 页面，交叉引用会随时间更新，回答问题时会引用那些已经包含了综合知识的 Wiki 页面。
该技能提供以下三种操作：
| 操作 | 功能描述 | 输出 |
|---|---|---|
| Ingest | 将资源收集到 raw/ 并编译进 Wiki | 新增或更新的 Wiki 页面 |
| Query | 搜索 Wiki 并附带引用进行回答 | 链接到 Markdown 页面的基础事实回答 |
| Lint | 检查索引完整性、链接和 Wiki 健康状况 | 自动修复并报告相关问题 |
查看 SKILL.md 以获取完整的技能规范。
LLM Wiki 与 RAG 的对比
| 方法 | 知识存储位置 | 综合处理发生时间 | 适用场景 |
|---|---|---|---|
| RAG | 原始数据块和 Embedding | 查询时 | 大规模语料库的广泛检索 |
| LLM Wiki | 精选的 Markdown 页面 | 录入和维护时 | 知识累积、摘要总结及持久化的交叉链接 |
该技能针对 Wiki 模型进行了优化：知识随时间推移而不断改进，无需在每次查询时重新推导关系。
使用统计
基于自 2026 年 4 月起每日维护的生产级知识库：
- 13 个主题目录下的 94 篇 Wiki 文章
- 已录入 99 份原始资料
- 过去 7 天内有 87 条操作日志记录
查看 examples/ 获取示例 Wiki 页面、源文件和操作日志。
安装
npx add-skill Astro-Han/karpathy-llm-wiki
适用于任何支持 Agent Skills 标准的工具。
快速上手
1. 录入你的第一个资源
提供一个 URL、文件或粘贴文本给该技能：
"Ingest this article: https://example.com/attention-is-all-you-need"
该技能会将资源存储在 raw/ 中，然后编译或更新 wiki/ 中对应的知识页面。
2. 向你的 Wiki 提问
"What do I know about attention mechanisms?"
该技能将搜索 Wiki，并给出带有链接回 Markdown 页面引用的回答。
3. 维护 Wiki 健康
"Lint my wiki"
检查断开的链接、缺失的索引条目、过期的交叉引用以及相关问题。
工作流原理
来自 Karpathy 的核心理念：由 LLM 维护 Wiki，而人类专注于选择资源并提出好问题。
your-project/
├── raw/ ← 不可变的原始资料
│ └── topic/
│ └── 2026-04-03-source-article.md
├── wiki/ ← 由 LLM 维护的已编译知识页面
│ ├── topic/
│ │ └── concept-name.md
│ ├── index.md ← 全局目录
│ └── log.md ← 只读追加的操作日志
每一个新资源都可以更新多个页面，强化交叉引用，并记录矛盾之处。这就是 Wiki 随时间推移不断累积知识的原因。
工具兼容性
该技能遵循 agentskills.io 开放标准：
| 工具 | 安装方式 |
|---|---|
| Claude Code | npx add-skill Astro-Han/karpathy-llm-wiki |
| Cursor | npx add-skill Astro-Han/karpathy-llm-wiki |
| Codex CLI | 复制到 .agents/skills/karpathy-llm-wiki/ |
| OpenCode | npx add-skill Astro-Han/karpathy-llm-wiki |
| 其他工具 | 将 SKILL.md 和 references/ 复制到工具的技能目录中 |
常见问题 (FAQ)
LLM Wiki 和个人 Wiki 有什么区别？
LLM Wiki 由模型进行维护。当新资料到达时，它会自动更新摘要、交叉链接、索引条目和处理矛盾。而普通的个人 Wiki 则依赖于人工编辑。
我可以录入哪些资源？
网页、论文、博客文章、PDF、Markdown 文件、文本文件以及粘贴的文本。