SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场llm-wiki-skill

llm-wiki-skill

写作与研究

查看项目

更新于 10-15 16:38

技能介绍

llm-wiki-skill 是一个多平台个人知识库构建技能，适用于 Claude Code、Codex 和 OpenClaw 智能体。它基于 Karpathy 的 llm-wiki 方法论：知识被编译一次并持续维护，而不是每次查询时从原始文档重新推导。

用途

该技能用于从 URL、PDF、Markdown 文件和纯文本构建持久、互链的个人知识库。它摄取文章、推文、PDF、YouTube 转录、微信公众号文章和纯文本，自动将每种来源类型路由到最佳提取工具，并生成结构化的 wiki 页面。

主要能力

  • 摄取多种来源：网页文章、X/Twitter、知乎、微信、YouTube、小红书（仅手动粘贴）、PDF、Markdown、纯文本。
  • 自动路由：根据来源类型选择提取工具，路由逻辑位于 scripts/source-registry.sh，来源注册表位于 scripts/source-registry.tsv。
  • 生成结构化 wiki 页面：实体页、主题页、来源摘要、对比分析、跨来源综合。
  • 使用 [[双向链接]] 连接实体与主题。
  • 输出兼容 Obsidian 的本地 Markdown 文件。
  • 健康检查：检测孤立页面（无入链）、失效的 [[wiki 链接]]、跨页面矛盾信息、缺失的来源摘要。

安装方式

推荐让智能体安装：将仓库 URL https://github.com/sdyckjq-lab/llm-wiki-skill 提供给智能体，并要求其为你的平台安装。

手动安装：克隆仓库到任意位置，然后按平台运行安装脚本：

Claude Code

bash install.sh --platform claude

Codex

bash install.sh --platform codex

OpenClaw

bash install.sh --platform openclaw

自动检测（仅当存在一个平台目录时）

bash install.sh --platform auto

自定义目标目录（OpenClaw 非标准路径）

bash install.sh --platform openclaw --target-dir /path/to/your/skills

默认安装位置：

  • Claude Code：~/.claude/skills/llm-wiki
  • Codex：~/.codex/skills/llm-wiki
  • OpenClaw：~/.openclaw/skills/llm-wiki

旧版 Claude 设置（现有用户）：bash setup.sh（现为统一安装器的兼容垫片）。

前置条件

检查 Chrome 调试模式是否运行（网页提取需要）

google-chrome --remote-debugging-port=9222 &

检查 uv 是否安装（微信 + YouTube 提取需要）

uv --version

安装 bun 或 npm（网页提取依赖，二选一即可）

curl -fsSL https://bun.sh/install | bash

或：大多数环境已自带 npm

平台入口点

安装后阅读平台特定说明：

  • Claude Code：platforms/claude/CLAUDE.md
  • Codex：platforms/codex/AGENTS.md
  • OpenClaw：platforms/openclaw/README.md

知识库结构

your-wiki/ ├── raw/ # 不可变源材料 │ ├── articles/ # 网页文章 │ ├── tweets/ # X/Twitter │ ├── wechat/ # 微信文章 │ ├── xiaohongshu/ # 小红书（仅手动粘贴） │ ├── zhihu/ # 知乎 │ ├── pdfs/ # PDF │ ├── notes/ # 笔记 │ └── assets/ # 图片、附件 ├── wiki/ # AI 生成的知识库 │ ├── entities/ # 人物、概念、工具 │ ├── topics/ # 主题页 │ ├── sources/ # 来源摘要 │ ├── comparisons/ # 并排分析 │ └── synthesis/ # 跨来源综合 ├── index.md # 主索引 ├── log.md # 操作日志 └── .wiki-schema.md # 配置

核心工作流

初始化新知识库：向智能体说“在 ~/my-wiki 创建一个新知识库”，智能体会搭建目录结构并生成 index.md、log.md 和 .wiki-schema.md。

摄取网页文章：“将此文章加入我的 wiki：https://example.com/article”，底层路由到 baoyu-url-to-markdown：npx baoyu-url-to-markdown https://example.com/article > raw/articles/article-slug.md

摄取 YouTube 视频：“将此 YouTube 视频消化进我的知识库：https://youtube.com/watch?v=abc123”，通过 uv 使用 youtube-transcript：uvx youtube-transcript https://youtube.com/watch?v=abc123 > raw/articles/video-slug.md

摄取微信文章：“将此微信文章加入我的 wiki：https://mp.weixin.qq.com/s/...”，通过 uv 使用 wechat-article-to-markdown：uvx wechat-article-to-markdown https://mp.weixin.qq.com/s/... > raw/wechat/article-slug.md

摄取 PDF：“将此 PDF 处理进我的 wiki：/path/to/paper.pdf”或拖入聊天，无需外部工具，直接进入主流程：cp /path/to/paper.pdf raw/pdfs/paper.pdf

摄取纯文本或笔记：直接粘贴文本给智能体，智能体写入 raw/notes/note-slug.md。

批量处理文件夹：“处理 ~/Downloads/research 中的所有文件进我的 wiki”，智能体遍历文件并按类型路由。

健康检查：“对我的知识库运行健康检查”，智能体检查孤立页面、失效 [[wiki 链接]]、跨页面矛盾信息、缺失来源摘要。

来源路由参考

  • 网页文章：baoyu-url-to-markdown，需要 Chrome 调试模式
  • X/Twitter：baoyu-url-to-markdown，需要 Chrome 调试模式 + X 登录
  • 知乎：baoyu-url-to-markdown，需要 Chrome 调试模式
  • 微信：wechat-article-to-markdown，需要 uv
  • YouTube：youtube-transcript，需要 uv
  • 小红书：手动粘贴，无要求
  • PDF / Markdown / 文本：直接流程，无要求

Wiki 页面约定

实体页示例（wiki/entities/andrej-karpathy.md）包含 Overview、Key Ideas（带 [[链接]]）、Sources、Related 等小节。主题页示例（wiki/topics/retrieval-augmented-generation.md）包含 Summary、Key Entities、Comparisons、Sources。来源摘要示例（wiki/sources/article-slug.md）包含 URL、Date ingested、Type、Key Points、Entities Mentioned、Raw 链接。

故障排除

Chrome / 网页提取失败：以远程调试启动 Chrome（google-chrome --remote-debugging-port=9222 --no-first-run &），用 curl http://localhost:9222/json/version 验证；X/Twitter 需确保该 Chrome 会话已登录。

微信或 YouTube 提取失败：安装 uv（curl -LsSf https://astral.sh/uv/install.sh | sh；source $HOME/.cargo/env），重新运行安装器，验证 uvx youtube-transcript --help 和 uvx wechat-article-to-markdown --help。

bun/npm 依赖安装失败：安装器自动选择 bun 或 npm，可用 which bun / which npm 检查；也可手动 npm install -g baoyu-url-to-markdown。

Codex 旧路径兼容：~/.Codex/skills（大写 C）与 ~/.codex/skills（小写，新默认）均自动支持。

智能体找不到已安装技能：用 ls 检查对应平台安装目录，缺失则重新运行安装器。

来源注册表查询：cat scripts/source-registry.tsv；测试路由：bash scripts/source-registry.sh route "https://mp.weixin.qq.com/s/example"。

关键设计原则

  • 编译一次，持续维护——wiki 页面是活文档，不是临时答案
  • 双向链接——每个实体和主题都用 [[name]] 链接到相关节点
  • 不可变原始材料——raw/ 中的源文件摄取后不再修改
  • 优雅降级——工具失败时智能体提示手动粘贴而非崩溃
  • 平台无关——同一知识库可在所有支持的智能体间使用
  • 兼容 Obsidian——可随时在 Obsidian 中直接打开 your-wiki/

智能体快速参考

初始化 wiki：“在 <路径> 创建新 wiki” 添加 URL：“将 <url> 加入我的 wiki” 添加文件：“将 <文件路径> 处理进我的 wiki” 添加文本：“将这些笔记加入我的 wiki：<文本>” 批量处理：“将 <文件夹> 中的所有文件处理进我的 wiki” 健康检查：“检查我的 wiki 中的失效链接和孤立页面” 查找信息：“我的 wiki 中关于 <主题> 说了什么” 更新页面：“用 <来源> 的新信息更新 [[实体]] 页面”