| name | llm-wiki |
| description | Karpathy 式持久 wiki（llm-wiki/）— 按门类路径组织 raw/wiki，Collect 先清单后落盘，ingest/query/lint/graph；融合 llm-wiki-agent、llm-wiki-skill、graphify 的设计思路，工具无 API Key。知识库根目录为仓库内 llm-wiki/。 |
LLM Wiki
执行前依赖检查
llm-wiki 工作流依赖以下外部 skill。Agent 在执行任何操作前，必须强制检查对应 skill 是否已安装在当前环境中。
检查方式：验证 skill 是否存在于 agent skill 目录（如 .agents/skills/<name>/、.qoder/skills/<name>/）或技能锁文件（skills-lock.json）中。
| 操作阶段 | 依赖 Skill | 安装命令 |
|---|
| Collect | tavily-search | npx skills add https://github.com/tavily-ai/skills --skill tavily-search |
| Collect | baoyu-url-to-markdown | npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-url-to-markdown |
| Collect | wechat-article-to-markdown | npx skills add https://github.com/jackwener/wechat-article-to-markdown --skill wechat-article-to-markdown |
| Collect | baoyu-youtube-transcript | npx skills add https://github.com/jimliu/baoyu-skills --skill baoyu-youtube-transcript |
| Ingest（成稿） | humanizer-zh | npx skills add https://github.com/op7418 --skill humanizer-zh |
| Ingest（可视化） | fireworks-tech-graph | npx skills add https://github.com/yizhiyanhua-ai/fireworks-tech-graph --skill fireworks-tech-graph |
| Ingest（演示） | html-ppt-skill | npx skills add https://skills.sh/lewislulu/html-ppt-skill/html-ppt |
强制规则：
- 执行任何操作前，先检查该阶段所需 skill 是否已安装
- 若发现缺失，必须询问用户是否安装，列出缺失 skill 及对应安装命令
- 未获得用户明确确认前，不得执行该操作
- 不允许跳过检查，不允许静默降级到手动流程
Do not skip this check. Do not proceed without user confirmation.
知识库根目录
llm-wiki/（与仓库根相对路径；也可单独拷贝本目录对外开源）
会话开始必读
llm-wiki/CLAUDE.mdllm-wiki/taxonomy.mdllm-wiki/wiki/index.md 与 wiki/overview.md
按任务追加：Collect → llm-wiki/skills/collect/SKILL.md + llm-wiki/tools/source_registry.tsv；写成稿 → llm-wiki/skills/wiki-writing/SKILL.md + llm-wiki/skills/humanizer-zh/SKILL.md
环境变量
export WIKI_ROOT="$PWD/llm-wiki"
工具命令
pip install -r llm-wiki/requirements.txt
bash llm-wiki/tools/check_all.sh "$WIKI_ROOT"
python3 llm-wiki/tools/build_graph.py --wiki-root "$WIKI_ROOT"
上游理念来源
与用户约定的流程
- Collect：Agent 检索 →
sessions/.../candidates.md → 用户确认 → 写入 raw/<门类>/… → ingest
- Taxonomy：新建/合并/重命名/删除门类目录前 必须用户明确同意
- 路径即分类：
raw/<shelf>/… 与 wiki/<shelf>/… 对齐
