RULES.md

LLM Wiki 知识库编译规则 - 通用版本

---

核心原则

1. Raw 层原则

00-待处理（入口层）

• ✅ 零门槛扔文件：无需改名、分类、写说明
• ❌ 不要手动整理：让 LLM 处理

分类文件夹（01-05）

• ✅ 只读追加：不修改、不删除，只新增
• ✅ 时间戳命名：YYYY-MM-DD-{描述}.{后缀}
• ✅ 来源标记：文件开头注明来源
• ❌ 不修改原文：即使有明显错误也保持原样

2. Wiki 层原则

• ✅ 自动生成：所有文档由 LLM 基于 raw 资料编译
• ✅ 可溯源：每个文档标注来源文件
• ✅ 增量更新：只更新相关条目，不重写整个库
• ✅ 冲突标记：观点矛盾时显式标记，不掩盖
• ❌ 人类不直接编辑（除非修正 LLM 错误）

3. 概念创建时机

概念页面需要至少在 2 篇不同来源中被提及，才创建独立页面：

• 第 1 次出现：在摘要中列出，不创建独立页面
• 第 2 次出现：创建独立概念页面

4. 人机分工

角色	职责
人类	筛选资料、制定规则、审核修改、仲裁冲突、提好问题
LLM	摘要提炼、概念提取、交叉链接、维护索引、扫描问题

核心思想：人类做决策，LLM 做苦力。

5. 冲突处理

1. 完全一致：合并信息，更新来源列表
2. 有差异但不矛盾：保留两种说法，标注来源差异
3. 直接矛盾：明确写出两种观点和来源，不强行统一，由人类仲裁

---

三步编译法

每次编译任何资料，严格执行：

第一步：浓缩

• 奥卡姆剃刀：删掉不影响理解的冗余信息
• 输出：核心结论（≤ 3 条）+ 关键证据

第二步：质疑

针对每条结论回答：

1. 依赖哪些前提假设？
2. 前提不成立时结论还成立吗？
3. 数据来源可靠吗？
4. 有没有反例或边界条件？

第三步：对标

1. 其他领域有类似现象吗？
2. 知识可迁移到哪些场景？
3. 有跨域关联则创建/更新概念条目

---

目录结构约定

项目根目录/
├── RULES.md            # 本文件 - 通用 Schema
├── docs/
│   ├── raw/            # 第一层：原始资料层（人类只往这里扔，不编辑）
│   │   ├── 00-待处理/      # 入口文件夹：直接扔文件，无需命名/分类
│   │   ├── 01-需求讨论/
│   │   ├── 02-会议纪要/
│   │   ├── 03-竞品分析/
│   │   ├── 04-设计原稿/
│   │   └── 05-运营数据/
│   │
│   └── wiki/           # 第二层：编译知识层（LLM 维护，人类只读）
│       ├── summaries/      # 逐篇编译摘要
│       ├── concepts/       # 概念条目（核心知识资产）
│       ├── methods/        # 方法论页面
│       ├── decisions/      # 决策记录（ADR）
│       ├── indexes/        # 索引和日志
│       ├── schema/         # Schema 扩展文档
│       └── tutorials/      # 教程

---

标准工作流

   导入(Ingest) → 编译(Compile) → 查询(Query) → 归档(File) → 体检(Lint)
        ↑                                                         ↓
        └─────────────────────────────────────────────────────────┘

步骤	人类做什么	LLM 做什么
导入	扔文件到 00-待处理/	读取 → 分类 → 重命名 → 补充来源 → 移动
编译	确认文件已归档	三步编译 → 更新概念 → 更新索引
查询	提好问题	读相关页面 → 综合推理 → 结构化回答
归档	判断回答价值	有价值则存为 Wiki 页面
体检	每周一次	扫描矛盾、断链、孤岛、缺口

---

技能速查表

技能	命令	说明	详细定义
导入	/ingest	处理待处理文件夹	ingest.md
编译	/compile 路径	编译单篇文章	compile.md
增量更新	/refresh-wiki	批量编译新文件	refresh-wiki.md
概念升级	/upgrade-concepts	创建独立概念页面	upgrade-concepts.md
问答	/wiki 问题	查询知识库	wiki.md
归档问答	/file-answer	存回 Wiki	file-answer.md
记录决策	/decision	创建 ADR	decision.md
健康检查	/health	扫描问题	health.md
核心理念	/why-llm-wiki	解释设计理念	why-llm-wiki.md

---

技能详细说明

技能：导入

命令：/ingest

触发词：

• "处理待处理文件夹"
• "导入新文件"
• "帮我处理 00-待处理 里的文件"
• "有新文件要处理"
• "扫描入口文件夹"
• "刚才扔的文件处理一下"

执行逻辑：

1. 扫描 docs/raw/00-待处理/ 目录
2. 读取每个文件内容，判断分类（需求讨论/会议纪要/竞品分析/设计原稿/运营数据）
3. 如果来源不明确，询问用户
4. 重命名（加日期前缀）并移动到对应分类文件夹
5. 在文件开头写入来源标记
6. 删除原文件，报告处理结果

详细定义：ingest.md

---

技能：编译

命令：/compile 文件路径

触发词：

• "编译这篇文章：[路径]"
• "处理这个文件：[路径]"
• "把这篇文章编译进知识库"
• "分析这篇文档"
• "编译 [文件名]"

执行逻辑：

1. 读取指定路径的原始文件
2. 执行三步编译法（浓缩 → 质疑 → 对标）
3. 生成摘要到 docs/wiki/summaries/
4. 提取概念，标记为"待观察"（首次出现）或创建独立页面（二次出现）
5. 更新 docs/wiki/indexes/index.md 和 log.md

详细定义：compile.md

---

技能：增量更新

命令：/refresh-wiki

触发词：

• "批量编译所有新文件"
• "处理所有未编译的文章"
• "更新知识库"
• "编译所有新文章"
• "批量处理"

执行逻辑：

1. 扫描 docs/raw/01-05/ 所有分类文件夹
2. 对比 docs/wiki/summaries/，找出未编译的文件
3. 按文件日期从早到晚依次编译
4. 遇到概念冲突时暂停，询问用户
5. 输出处理报告

详细定义：refresh-wiki.md

---

技能：概念升级

命令：/upgrade-concepts

触发词：

• "升级待观察概念"
• "创建独立概念页面"
• "检查哪些概念达到阈值"
• "批量创建概念"

执行逻辑：

1. 扫描所有摘要，统计概念出现次数
2. 找出出现 ≥ 2 次但尚未创建独立页面的概念
3. 为每个概念创建独立页面到 docs/wiki/concepts/
4. 更新相关摘要的关联链接

详细定义：upgrade-concepts.md

---

技能：问答

命令：/wiki 问题

触发词：

• "查询知识库：[问题]"
• "根据知识库回答：[问题]"
• "知识库里有什么关于 [主题] 的内容"
• "查一下 [问题]"
• 以问号结尾的疑问句（自动推断为查询）

执行逻辑：

1. 分析问题，识别关键词和概念
2. 读取相关摘要和概念页面
3. 综合推理，给出结构化回答
4. 标注信息来源

详细定义：wiki.md

---

技能：归档问答

命令：/file-answer --title "标题"

触发词：

• "归档这个回答"
• "把这个存到知识库"
• "保存刚才的回答"
• "这个回答有价值，存起来"

执行逻辑：

1. 提取最近一次问答内容
2. 整理成决策记录格式
3. 写入 docs/wiki/decisions/
4. 更新索引

详细定义：file-answer.md

---

技能：记录决策

命令：/decision --title "标题"

触发词：

• "记录决策：[标题]"
• "记录这个决定"
• "创建 ADR"
• "我要记录一个架构决策"
• "这个决策需要记录下来"

执行逻辑：

1. 询问决策背景、内容、理由、替代方案
2. 生成 ADR 格式文档
3. 写入 docs/wiki/decisions/ADR-xxx.md
4. 更新索引

详细定义：decision.md

---

技能：健康检查

命令：/health

触发词：

• "检查知识库健康状态"
• "体检知识库"
• "扫描知识库问题"
• "检查有没有断链或孤岛"
• "知识库体检"

执行逻辑：

1. 断链检查：引用的文件是否存在
2. 孤岛检测：概念页面是否被引用
3. 定义冲突：不同文章说法是否矛盾
4. 来源缺失：文件是否缺少来源标记
5. 输出检查报告和修复建议

详细定义：health.md

---

技能：核心理念

命令：/why-llm-wiki

触发词：

• "解释设计理念"
• "为什么要用这套体系"
• "LLM Wiki 是什么"
• "这套体系的原理是什么"

执行逻辑：
解释三层架构、三步编译法、知识复利、人机分工等核心理念。

详细定义：why-llm-wiki.md

---

歧义消解规则

当用户意图不明确时，按以下规则推断：

用户表述特征	推断技能
提到"00-待处理"、"刚扔了文件"、"入口文件夹"	导入（Ingest）
提到具体文件路径（如 docs/raw/01-需求讨论/xxx.md）	编译（Compile）
以问号结尾或疑问句式	问答（Wiki Query）
提到"决策"、"决定"、"ADR"	记录决策（Decision）
提到"体检"、"检查"、"健康"	健康检查（Health）
提到"归档"、"保存回答"	归档问答（File Answer）

---

最佳实践清单

✅ 扔文件到 00-待处理/ → 导入 → 编译
✅ 每次只编译一篇文章，质量比速度重要
✅ 积累 3-5 篇后运行概念升级
✅ 每周运行一次健康检查
✅ 不直接编辑 wiki 文件，有新信息就新增 raw 文件
✅ 高质量问答归档回去

---

扩展文档

文档	说明
docs/wiki/schema/formats.md	所有文档格式模板
docs/wiki/schema/skills.md	技能详细说明
docs/wiki/tutorials/quick-start.md	快速上手教程

---

工具适配说明

工具	配置文件	说明
Claude Code	CLAUDE.md	自动读取项目根目录
OpenAI Codex	AGENTS.md	自动读取项目根目录
Cursor	.cursorrules	自动读取，需精简版
GitHub Copilot	.github/copilot-instructions.md	自动读取
其他工具	按工具约定	引用或复制本文件

同步方式

Linux / Mac：

# 符号链接
ln -s RULES.md CLAUDE.md
ln -s RULES.md AGENTS.md

Windows (PowerShell)：

# 符号链接（需要管理员权限）
New-Item -ItemType SymbolicLink -Path CLAUDE.md -Target RULES.md
# 或直接复制（推荐）
Copy-Item RULES.md CLAUDE.md

Cursor 注意：.cursorrules 不支持引用语法，需要从 RULES.md 提取精简版本（60 行以内）。