卡帕蒂维基
- 作者仓库星标 983
- 作者仓库 karpathy-llm-wiki
- 领域
- 人工智能
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @Astro-Han · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Karpathy LLM Wiki
Build and maintain a personal knowledge base using LLMs. You manage two directories: `raw/` (immutable source material) and `wiki/` (compiled knowledge articles). Sources go into raw/, you compile them into wiki articles, and the wiki compounds over time.
Core ideas from Karpathy:
- "The LLM writes and maintains the wiki; the human reads and asks questions."
- "The wiki is a persistent, compounding artifact."
## Architecture
Three layers, all under the user's project root:
**raw/** — Immutable source material. You read, never modify. Organized by topic subdirectories (e.g., `raw/machine-learning/`).
**wiki/** — Compiled knowledge articles. You have full ownership. Organized by topic subdirectories, one level only: `wiki/<topic>/<article>.md`. Contains two special files:
- `wiki/index.md` — Global index. One row per article, grouped by topic, with link + summary + Updated date.
- `wiki/log.md` — Append-only operation log.
**SKILL.md** (this file) — Schema layer. Defines structure and workflow rules.
Templates live in `references/` relative to this file. Read them when you need the exact format for raw files, articles, archive pages, or the index.
### Initialization
Triggers only on the first Ingest. Check whether `raw/` and `wiki/` exist. Create only what is missing; never overwrite existing files:
- `raw/` directory (with `.gitkeep`)
- `wiki/` directory (with `.gitkeep`)
- `wiki/index.md` — heading `# Knowledge Base Index`, empty body
- `wiki/log.md` — heading `# Wiki Log`, empty body
If Query or Lint cannot find the wiki structure, tell the user: "Run an ingest first to initialize the wiki." Do not auto-create.
---
## Ingest
Fetch a source into raw/, then compile it into wiki/. Always both steps, no exceptions.
### Fetch (raw/)
1. Get the source content using whatever web or file tools your environment provides. If nothing can reach the source, ask the user to paste it directly.
2. Pick a topic directory. Check existing `raw/` subdirectories first; reuse one if the topic is close enough. Create a new subdirectory only for genuinely distinct topics.
3. Save as `raw/<topic>/YYYY-MM-DD-descriptive-slug.md`.
- Slug from source title, kebab-case, max 60 characters.
- Published date unknown → omit the date prefix from the file name (e.g., `descriptive-slug.md`). The metadata Published field still appears; set it to `Unknown`.
- If a file with the same name already exists, append a numeric suffix (e.g., `descriptive-slug-2.md`).
- Include metadata header: source URL, collected date, published date.
- Preserve original text. Clean formatting noise. Do not rewrite opinions.
See `references/raw-template.md` for the exact format.
### Compile (wiki/)
Determine where the new content belongs:
- **Same core thesis as existing article** → Merge into that article. Add the new source to Sources/Raw. Update affected sections.
- **New concept** → Create a new article in the most relevant topic directory. Name the file after the concept, not the raw file.
- **Spans multiple topics** → Place in the most relevant directory. Add See Also cross-references to related articles elsewhere.
These are not mutually exclusive. A single source may warrant merging into one article while also creating a separate article for a distinct concept it introduces. In all cases, check for factual conflicts: if the new source contradicts existing content, annotate the disagreement with source attribution. When merging, note the conflict within the merged article. When the conflicting content lives in separate articles, note it in both and cross-link them.
See `references/article-template.md` for article format. Key points:
- Sources field: author, organization, or publication name + date, semicolon-separated.
- Raw field: markdown links to raw/ files, semicolon-separated.
- Relative paths from `wiki/<topic>/` use `../../raw/<topic>/<file>.md` (two levels up to project root).
### Cascade Updates
After the primary article, check for ripple effects:
1. Scan articles in the same topic directory for content affected by the new source.
2. Scan `wiki/index.md` entries in other topics for articles covering related concepts.
3. Update every article whose content is materially affected. Each updated file gets its Updated date refreshed.
Archive pages are never cascade-updated (they are point-in-time snapshots).
### Post-Ingest
Update `wiki/index.md`: add or update entries for every touched article. When adding a new topic section, include a one-line description. The Updated date reflects when the article's knowledge content last changed, not the file system timestamp. See `references/index-template.md` for format.
Append to `wiki/log.md`:
```
## [YYYY-MM-DD] ingest | <primary article title>
- Updated: <cascade-updated article title>
- Updated: <another cascade-updated article title>
```
Omit `- Updated:` lines when no cascade updates occur.
---
## Query
Search the wiki and answer questions. Examples of triggers:
- "What do I know about X?"
- "Summarize everything related to Y"
- "Compare A and B based on my wiki"
### Steps
1. Read `wiki/index.md` to locate relevant articles.
2. Read those articles and synthesize an answer.
3. Prefer wiki content over your own training knowledge. Cite sources with markdown links: `[Article Title](wiki/topic/article.md)` (project-root-relative paths for in-conversation citations; within wiki/ files, use paths relative to the current file).
4. Output the answer in the conversation. Do not write files unless asked.
### Archiving
When the user explicitly asks to archive or save the answer to the wiki:
1. Write the answer as a new wiki page. See `references/archive-template.md`. When converting conversation citations to the archive page, rewrite project-root-relative paths (e.g., `wiki/topic/article.md`) to file-relative paths (e.g., `../topic/article.md` or `article.md` for same-directory).
- Sources: markdown links to the wiki articles cited in the answer.
- No Raw field (content does not come from raw/).
- File name reflects the query topic, e.g., `transformer-architectures-overview.md`.
- Place in the most relevant topic directory.
2. Always create a new page. Never merge into existing articles (archive content is a synthesized answer, not raw material).
3. Update `wiki/index.md`. Prefix the Summary with `[Archived]`.
4. Append to `wiki/log.md`:
```
## [YYYY-MM-DD] query | Archived: <page title>
```
---
## Lint
Quality checks on the wiki. Two categories with different authority levels.
### Deterministic Checks (auto-fix)
Fix these automatically:
**Index consistency** — compare `wiki/index.md` against actual wiki/ files (excluding index.md and log.md):
- File exists but missing from index → add entry with `(no summary)` placeholder. For Updated, use the article's metadata Updated date if present; otherwise fall back to file's last modified date.
- Index entry points to nonexistent file → mark as `[MISSING]` in the index. Do not delete the entry; let the user decide.
**Internal links** — for every markdown link in wiki/ article files (body text and Sources metadata), excluding Raw field links (validated by Raw references below) and excluding index.md/log.md (handled above):
- Target does not exist → search wiki/ for a file with the same name elsewhere.
- Exactly one match → fix the path.
- Zero or multiple matches → report to the user.
**Raw references** — every link in a Raw field must point to an existing raw/ file:
- Target does not exist → search raw/ for a file with the same name elsewhere.
- Exactly one match → fix the path.
- Zero or multiple matches → report to the user.
**See Also** — within each topic directory:
- Add obviously missing cross-references between related articles.
- Remove links to deleted files.
### Heuristic Checks (report only)
These rely on your judgment. Report findings without auto-fixing:
- Factual contradictions across articles
- Outdated claims superseded by newer sources
- Missing conflict annotations where sources disagree
- Orphan pages with no inbound links from other wiki articles
- Missing cross-topic references
- Concepts frequently mentioned but lacking a dedicated page
- Archive pages whose cited source articles have been substantially updated since archival
### Post-Lint
Append to `wiki/log.md`:
```
## [YYYY-MM-DD] lint | <N> issues found, <M> auto-fixed
```
---
## Conventions
- Standard markdown with relative links throughout.
- wiki/ supports one level of topic subdirectories only. No deeper nesting.
- Today's date for log entries, Collected dates, and Archived dates. Updated dates reflect when the article's knowledge content last changed. Published dates come from the source (use `Unknown` when unavailable).
- Inside wiki/ files, all markdown links use paths relative to the current file. In conversation output, use project-root-relative paths (e.g., `wiki/topic/article.md`).
- Ingest updates both `wiki/index.md` and `wiki/log.md`. Archive (from Query) updates both. Lint updates `wiki/log.md` (and `wiki/index.md` only when auto-fixing index entries). Plain queries do not write any files.
章节与文件索引
按说明文件中的顺序排列。
建筑
初始化
摄取
获取(原始/)
编译(维基/)
文件/命令 -> raw/ · wiki/ · raw/machine-learning/ · wiki/<topic>/<article>.md · wiki/index.md · wiki/log.md · references/ · .gitkeep
内容校验值 -> 458e695534b3
当前原文的自动摘译,尚未人工审校。
建筑
三层,全部位于用户的项目根目录下: raw/ — 不可变的源材料。您阅读,切勿修改。按主题子目录组织(例如,
raw/machine-learning/)。 wiki/ — 编译的知识文章。您拥有完全的所有权。按主题子目录组织,仅一级:wiki/<topic>/<article>.md。包含两个特殊文件:wiki/index.md— 全局索引。每篇文章一行,按主题分组,包含链接+摘要+更新日期。初始化
仅在第一次摄取时触发。检查
raw/和wiki/是否存在。只创造缺失的东西;永远不会覆盖现有文件:raw/目录(带有.gitkeep)wiki/目录(带有.gitkeep)wiki/index.md— 标题# Knowledge Base Index,空正文wiki/log.md— 标题# Wiki Log,空正文摄取
将源代码获取到 raw/,然后将其编译到 wiki/。总是这两个步骤,没有例外。
获取(原始/)
使用您的环境提供的任何 Web 或文件工具获取源内容。如果没有任何内容可以到达源,请用户直接粘贴。选择一个主题目录。首先检查现有的
raw/子目录;如果主题足够接近,请重复使用一个。仅为真正不同的主题创建一个新的子目录。另存为raw/<topic>/YYYY-MM-DD-descriptive-slug.md。来自源标题的 Slug,短横线大小写,最多 60 个字符。编译(维基/)
确定新内容所属的位置:与现有文章相同的核心论文 → 合并到该文章中。将新源添加到 Sources/Raw。更新受影响的部分。新概念→在最相关的主题目录中创建一篇新文章。以概念命名文件,而不是原始文件。跨越多个主题 → 放置在最相关的目录中。添加对其他地方相关文章的“另请参阅”交叉引用。