CLAUDE.md 3.1 KB

LLM Wiki 工作约定

本目录是一个个人 LLM Wiki。目标不是简单保存资料,而是让 LLM 持续阅读、提炼、整合和维护一个结构化 Markdown 知识库。

目录结构

raw/           # 原始资料,只读不改
assets/    # 图片、附件、截图等原始资源
wiki/          # LLM 生成和维护的知识库页面
wiki/index.md  # 全局索引
wiki/log.md    # 操作日志

核心原则

  • raw/ 是事实来源,导入后不要修改原始文件。
  • wiki/ 是经过整理的知识层,可以持续更新、合并、修订和交叉引用。
  • 每次导入都要更新 wiki/index.mdwiki/log.md
  • 重要实体、概念、工作流应拆成独立页面,并使用 [[wikilink]] 建立双向关联。
  • 新资料与旧资料冲突时,应明确标注矛盾,不要静默覆盖。
  • 查询中产生的高价值综合结论,可以回写为新的 Wiki 页面。

页面命名

  • 资料摘要:source-{关键词}.md
  • 实体页:{实体名}.md
  • 概念页:{概念名}.md
  • 工作流页:{场景}-workflow.md

文件名优先使用小写英文、数字和连字符。中文主题可以使用拼音、英文关键词,或在确有必要时使用中文文件名。

Frontmatter 模板

资料摘要页:

---
tags: [source-summary]
type: source
source: "原文标题"
author: ""
date: YYYY-MM-DD
url: ""
created: YYYY-MM-DD
---

实体页:

---
tags: [entity]
type: entity
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

概念页:

---
tags: [concept]
type: concept
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

Ingest 工作流

当用户要求“导入”“处理资料”“添加到知识库”时:

  1. 读取 raw/ 中的目标资料。
  2. 提炼核心观点、关键事实、案例、数据和可复用方法。
  3. 创建 wiki/source-{关键词}.md 摘要页。
  4. 创建或更新相关实体页、概念页和工作流页。
  5. 在相关页面底部添加来源链接,指回摘要页。
  6. 更新 wiki/index.md
  7. 追加 wiki/log.md,记录新增和更新页面。
  8. 标注与已有内容的共同主题、补充关系或矛盾。

Query 工作流

当用户向知识库提问或要求分析时:

  1. 先读取 wiki/index.md 定位相关页面。
  2. 再读取具体 Wiki 页面和必要的原始资料。
  3. 综合回答,并引用相关 Wiki 页面或原始资料。
  4. 如果回答形成稳定结论,询问或直接回写到 Wiki 页面。

Lint 工作流

当用户要求“检查知识库”“维护一下”“lint wiki”时:

  1. 检查孤立页面和缺失入站链接。
  2. 检查被提及但没有独立页面的重要实体或概念。
  3. 检查相互矛盾或过时内容。
  4. 检查 wiki/index.md 是否覆盖所有重要页面。
  5. 给出修复建议,并在确认后执行整理。

Obsidian 使用建议

  • 用 Obsidian 打开本目录作为 Vault。
  • 通过图谱视图观察页面连接。
  • 用搜索和反向链接检查概念网络是否健康。
  • 可以后续安装 Dataview 插件,用 frontmatter 生成动态列表。