wikilisted
Install: claude install-skill cclank/lanshu-wiki-skill
# LLM Wiki Skill
让 LLM 增量构建并维护一个持久化的 Markdown 知识库,基于 [Karpathy 的 LLM Wiki 模式](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)。
---
## Step 1:定位 wiki root(每次触发先做这件事)
按下列规则**自上而下**判断,命中即停:
| 条件 | wiki root | 模式 |
|---|---|---|
| CWD 或任一上级目录含 `SCHEMA.md` + `index.md` | 该目录 | **code-repo** |
| CWD 是 `~/wiki/` 或其子目录 | `~/wiki/` | **personal** |
| CWD 含 `CLAUDE.md` + `index.md`(且不是项目源码的 CLAUDE.md) | CWD | **personal** |
| 上述都不满足,但用户在说 wiki 操作 | `~/wiki/`(默认) | **personal** |
| 用户明确说"建一个新 wiki" | 走 [Step 4:新建 wiki 引导](#step-4新建-wiki-引导) | — |
**模式的本质区别**:
- **personal**:跟踪多元来源(文章 / 视频 / PDF)的阅读笔记,目录五层(`raw/sources/entities/concepts/syntheses/`),有 reliability 分级
- **code-repo**:跟踪单一开源项目源码的架构 wiki,目录三层(`concepts/entities/changelog/`,可选 `guide/`),结论必带 `文件:行号`
---
## Step 2:读 schema 获取所有规则(一次性)
每次新会话首次触发 wiki 操作时,**先读取**当前 wiki root 的 schema 文件:
- **personal 模式** → 读 `<wiki-root>/CLAUDE.md`
- **code-repo 模式** → 读 `<wiki-root>/SCHEMA.md`
**schema 文件是唯一权威**——所有页面格式、标签体系、frontmatter 字段、ingest 步骤、lint 检查项都在里面。本 SKILL.md **不重复** schema 内容,只做路由。
> 如果 schema 文件缺失,说明这个 wiki 还没正确初始化 → 走 [Step 4](#step-4新建-wiki-引导)。
---
## Step 3:会话启动协议(首次触发时执行)
按顺序:
1. 读 schema(见 Step 2)
2. 读 `<wiki-root>/index.md` —— 了解 wiki 全貌(不读全文,了解有哪些页面)
3. 读 `<wiki-root>/log.md` 最后 10 条 —— 了解最近做了什么
4. 读 `<wiki-root>/inbox.md`(如存在)—— 看是否有待处理项
5. 一句话向用户汇报:「wiki 状态:N 个页面,最近操作 X,待处理 Y 项」
后续操作只要不切换 wiki root 就不重复读这些。
---
## Step 4:新建 wiki 引导
用户在一个**没有现成 wiki 标记**的目录说"建一个 wiki"、"给 X 做架构 wik