LLM Wiki(Karpathy 风格)是一个用 LLM 构建并维护个人知识库的技能。核心理念为「LLM 撰写并维护 wiki;人类阅读并提问」,强调「Wiki 是持久、可复利的产物」。操作化实践参考 astro-han/karpathy-llm-wiki,理念参考 Karpathy gist 与 LLM Wiki Architecture。
【用途】 管理两个目录:raw/(不可变来源)与编译后的知识页(wiki/ 主题目录,或本项目的 entities/、concepts/、synthesis/ 等)。来源进入 raw/,再编译为文章;wiki 随时间复利增长。
【标准口令】
- 加入 wiki:… → Ingest(摄取)
- 关于 X 我知道什么 → Query(默认不写文件)
- lint wiki → Lint(优先跑 scripts/lint-wiki.sh)
- 本周回顾 / 本月回顾 → 运营回顾,见 references/ops-loop.md 随手记先入 raw/inbox/,再 ingest。分通道摄取见 references/source-adapters.md。
【架构】 三层,均在用户项目根(或已解析的 wiki 根)下:
- raw/ — 不可变来源(inbox/ 除外可移动)。类型布局推荐子目录:inbox/ articles/ papers/ transcripts/ notes/ git/ lark/ mail/ meeting/ assets/。
- 编译知识层 — 拥有完整写权限。两种兼容布局(以既有 SCHEMA.md / 目录为准,勿强行迁移):主题布局 wiki/<topic>/<article>.md,仅一层主题子目录;类型布局 entities/ concepts/ comparisons/ queries/ synthesis/,外加 _archive/。
- 特殊文件(在 wiki 根):index.md 全局索引(每文一行,按主题/类型分组,含链接 + 摘要 + Updated);log.md 追加式操作日志(## [YYYY-MM-DD] <action> | <主题>);SCHEMA.md / 本 SKILL.md 约定层。 模板在相对本文件的 references/。确定性脚本:scripts/init-wiki.sh、lint-wiki.sh、new-raw.sh、rehash-raw.sh。
【初始化】 默认在首次 Ingest 时触发。检查 raw/ 与编译知识层是否存在;只创建缺失项,永不覆盖已有文件。可用启动脚本:bash "${SKILL_DIR}/scripts/init-wiki.sh" "$WIKI" "$DOMAIN",printf '%s\n' "$WIKI" > "$HOME/.llm-wiki"。最小手建(主题布局):raw/、wiki/、wiki/index.md、wiki/log.md。Wiki 根解析:用户显式路径 > WIKI_PATH > ~/.llm-wiki > 当前目录 > ~/wiki。若 Query / Lint 找不到 wiki 结构,告知用户「先跑一次 ingest 以初始化 wiki」,不要自动创建。
【Ingest 摄取】 把来源抓进 raw/,再编译进知识层,两步都必须做。Fetch:用环境提供的网页/文件工具取得内容;选择主题目录;保存为 raw/<topic>/YYYY-MM-DD-descriptive-slug.md;元数据含来源 URL、Collected、Published;忠实保留原文。Compile:判断新内容归属,与既有文章同一核心论题则合并,新概念则新建文章,跨多主题则放最相关目录并互链。Cascade Updates:扫描同主题受影响文章并更新。Post-Ingest:更新 index.md 并追加 log.md。
【Query 查询】 搜索 wiki 并回答。步骤:读 index.md 定位相关文章;阅读并综合答案;优先 wiki 内容而非训练先验;答案输出在对话中,除非被要求否则不写文件。
【Archiving 归档】 仅当用户明确要求归档或保存答案到 wiki 时执行。写成新 wiki 页,Sources 指向答案所引的 wiki 文章,无 Raw 字段,始终新建页,更新 index.md 并追加 log.md。
【Lint 质量检查】 确定性检查(自动修复):优先运行 bash "${SKILL_DIR}/scripts/lint-wiki.sh" "$WIKI",覆盖索引缺失/断链、frontmatter 必填字段、wikilink、raw 引用、孤儿页启发式。启发式检查(只报告):跨文事实矛盾、过期主张、无入链孤儿页、缺少跨主题引用等。
【约定】 标准 Markdown;主题布局 wiki/ 仅一层主题子目录;日志/Collected/Archived 用当天日期;Updated = 知识内容实质变更日;Ingest 更新 index.md + log.md;纯 Query 不写任何文件;优先更少但更强的页面;完整约定以 SCHEMA.md 为准。
【参考模板】 references/raw-template.md(不可变来源)、source-adapters.md(博客/PDF/对话/Git/飞书邮件会议适配)、ops-loop.md(口令、inbox、周/月回顾)、article-template.md(编译后的知识文章)、archive-template.md(查询归档)、index-template.md(全局索引)、log-template.md(操作日志)、entity-template.md 等(类型布局专用页)。
【限制】 资料未提供具体收费、价格、平台支持范围等信息。