llmwiki-init

LLM Wiki 初始化

在当前项目中建立一个由 LLM 维护的持久化 wiki。这个技能适用于第一次搭建知识库结构时使用。

目标

• 创建稳定的 wiki/ 目录结构
• 明确原始来源目录和生成内容目录的边界
• 初始化 index.md、log.md、.manifest.json
• 在可用时接入 qmd，为后续搜索和维护做准备
• 让后续的 llmwiki-ingest、llmwiki-search、llmwiki-optimize、llmwiki-health 有统一约定

何时使用

• 用户要把一批 Markdown 笔记、论文、文章沉淀成可持续维护的 wiki
• 用户想在 Obsidian 或本地仓库里搭建“会持续生长”的知识库
• 项目里还没有 wiki/ 目录，或者只有零散页面、缺少统一结构

工作原则

• 原始来源目录是只读的，LLM 不应修改它们
• wiki/ 是 LLM 生成和维护的产物目录
• 所有 wiki 页面都应使用 Obsidian 兼容的 [[wikilinks]]
• wiki/ 下除 index.md 和 log.md 之外的所有 Markdown 页面都必须包含 #llmwiki 标签，供 spaced repetition 按标签筛选复习
• 文件名统一使用小写 kebab-case
• 初始化时如果发现已有非空 wiki，应先判断是否增量兼容，避免覆盖用户内容

推荐目录约定

原始来源目录：

300 Resources/
Books/
200 Areas/

生成的 wiki 目录：

wiki/
├── index.md
├── log.md
├── .manifest.json
├── entities/
├── concepts/
├── stories/
├── sources/
├── comparisons/
└── synthesis/

如果用户已有等价目录结构，可以沿用，但要在最终说明里明确映射关系。

执行步骤

1. 预检查

• 检查 wiki/ 是否已存在
• 检查 wiki/index.md、wiki/log.md、wiki/.manifest.json 是否已存在
• 检查原始来源目录是否存在；缺失时可以创建空目录，或者按用户当前仓库结构调整
• 如果已有非空 wiki，先识别是“首次初始化”还是“修复结构”

2. 创建基础文件

初始化以下文件：

• wiki/index.md
• wiki/log.md
• wiki/.manifest.json

建议模板：

wiki/index.md

# Wiki Index

## Entities

## Concepts

## Stories

## Sources

## Comparisons

## Synthesis

wiki/log.md

# Wiki Log

wiki/.manifest.json

{}

3. 定义页面规范

每个 wiki 页面都应包含 YAML frontmatter：

---
title: 页面标题
type: entity | concept | source | story | comparison | synthesis
tags: [llmwiki, 标签1, 标签2]
sources: [相对路径/到/原始文件.md]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

正文中：

• 使用 [[页面标题]] 建立交叉引用
• 页面内容优先保留综合信息，而不是整段抄录原文
• 尽量让链接双向可达
• 在正文开头或合适位置显式写入 #llmwiki，确保 Obsidian 可按标签筛选；index.md 和 log.md 不需要这个标签

4. 配置搜索能力

优先检查 qmd 是否可用：

• 如果可用，将 wiki/ 注册为集合，例如 wiki
• 运行索引更新
• 如支持语义嵌入，可选执行 qmd embed

如果 qmd 不可用：

• 明确告知用户可以继续使用此工作流
• 后续搜索退化为 index.md + 文件扫描 + 精确检索

5. 记录初始化结果

在 wiki/log.md 追加一条初始化记录，说明：