# knowledge-wiki-skill

**Repository Path**: ijboy/knowledge-wiki-skill

## Basic Information

- **Project Name**: knowledge-wiki-skill
- **Description**: 这是一个个人wiki知识库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-07
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LLM Wiki

基于 LLM 增量构建和维护的持久化个人知识库。

## 这是什么

一个三层架构的个人知识管理系统：

- **原始资料层** (`raw/`) — 你收集的源文件，只读不写，事实的来源
- **Wiki 层** (`wiki/`) — LLM 生成维护的互联 markdown 知识网络
- **Schema 层** (`.claude/skills/llm-wiki/SKILL.md`) — 定义 wiki 结构、约定和工作流的 skill 文件

与传统 RAG 不同，这个知识库会**复合增长**：每添加一份资料，不只是索引起来等检索，而是立即消化、提取关键信息、整合进已有 wiki——更新实体页面、修订主题摘要、标注矛盾、强化综合判断。

## 项目结构

```
.
├── raw/                          # 原始资料（只读）
├── wiki/                         # LLM 维护的知识库
│   ├── index.md                  # 内容目录
│   ├── log.md                    # 操作日志
│   ├── entities/                 # 实体页面（人物、项目、工具等）
│   ├── concepts/                 # 概念/主题页面
│   ├── summaries/                # 资料来源摘要
│   └── synthesis/                # 综合分析页面
├── assets/                       # wiki 页面引用的图片和附件
└── .claude/skills/llm-wiki/      # Skill 定义（项目级）
    └── SKILL.md
```

## 当前知识库内容

Wiki 已摄入以下资料，可直接查询：

| 资料 | 页面数 | 可查询的主题 |
|------|--------|--------------|
| **Pro Git** | 30 个概念页 | Git 三区模型、分支/合并/变基、远程协作、stash/reset/cherry-pick、PR 工作流、diff/blame/bisect 等 |
| **毛主席语录** | 7 个概念页 | 军事思想、革命理论、哲学辩证法、外交战略、治国理政、人生修养、文化教育 |

**直接提问示例：**

```
Git reset --soft 和 --hard 有什么区别？
毛主席的"三个世界"理论是什么意思？
矛盾论的核心观点是什么？
```

## 安装

### 前提条件

- 安装 [Claude Code](https://claude.com/claude-code)
- 克隆本项目到本地

### 项目内使用

将此项目作为工作目录打开即可。`.claude/skills/llm-wiki/SKILL.md` 作为项目级 skill 会自动被发现。

### 在任意项目中使用（全局安装）

将 skill 安装为用户级，即可在任何工作目录下查询和使用 wiki：

```bash
# 将 skill 链接到 Claude Code 用户级 skills 目录
mkdir -p ~/.claude/skills/llm-wiki

# 注意：需要将 SKILL.md 中所有路径替换为 wiki 项目的绝对路径
# 将 WIKI_ROOT 替换为实际路径后再执行
cp /path/to/knowledge-wiki-skill/.claude/skills/llm-wiki/SKILL.md \
   ~/.claude/skills/llm-wiki/SKILL.md
```

然后在 Claude Code 中执行 `/reload-skills`，确认 `llm-wiki` 出现在可用技能列表中。

> **注意**：全局安装后，需要将 SKILL.md 中 `wiki/`、`raw/` 等相对路径改为 wiki 项目的绝对路径，否则 skill 会去当前工作目录下找文件。

## 使用方式

在 Claude Code 对话中直接操作，skill 会根据上下文自动激活。

三种核心操作：

### 1. Ingest（消化资料）

将资料放入 `raw/` 目录，然后说：

```
消化 raw/某文件.txt
```

LLM 会自动：读取资料 → 写摘要页 → 扫描实体 → 创建/更新实体和概念页 → 更新索引 → 写操作日志。

### 2. Query（查询）

直接对 wiki 提问，LLM 会从索引出发，阅读相关页面，综合多页信息给出有来源引用的回答：

```
Git rebase 和 merge 有什么区别？
毛主席的军事思想核心是什么？
```

有价值的分析可以提议归档为 synthesis 页面。

### 3. Lint（健康检查）

定期检查 wiki 健康状况：

```
检查 wiki 健康状况
```

按六个维度诊断：矛盾检查、过期内容、孤立页面、缺失覆盖、缺失交叉引用、知识空白。

## 自定义

本项目的目录结构、页面模板、约定都是初始默认值。在使用过程中可以根据自己的领域和习惯调整——直接修改 `.claude/skills/llm-wiki/SKILL.md` 中对应部分即可，每次迭代都会沉淀下来。

## License

MIT