knowledge-wiki

知识 Wiki

在 knowledge/ 目录中维护一个持久、结构化的知识库。

核心操作

1. 摄取 — 用户分享文章、文档或资源

1. 阅读并理解源材料
2. 提取关键事实、洞见和结构化知识
3. 确定合适的子目录：
   • 阅读 knowledge/index.md 查看现有分类
   • 如果存在匹配的分类，遵循该结构
   • 如果不存在，创建一个名称清晰的新子目录
4. 创建知识页面：knowledge/<category>/<slug>.md
5. 更新 knowledge/index.md 并追加到 knowledge/log.md

2. 综合 — 对话产生有价值的结构化知识

1. 在合适的分类下创建知识页面
2. 用交叉引用更新相关页面
3. 更新 knowledge/index.md 和 knowledge/log.md

3. 查询 — 用户询问已积累的知识

1. 检查 knowledge/index.md（已在你的上下文中）以查找相关页面
2. 使用 read 工具读取特定页面
3. 如有需要，用 memory_search 补充

页面格式

# Page Title

> Source: <URL or description of the original material>

Content here. Cross-reference related pages with markdown links:
[Related Page](../category/related-page.md)

## Key Points

- ...

## Related

- [Page A](../category/page-a.md) — how it relates
- [Page B](../category/page-b.md) — how it relates

> Source: 行记录知识的来源（URL、文档名称、对话等）。当材料来自特定来源时，始终包含它。

交叉引用构建知识图谱。创建或更新页面时，链接到相关页面并更新那些页面以反向链接。只链接到已存在的页面 — 如果某个概念值得拥有自己的页面，先创建它，然后添加链接。

索引格式（knowledge/index.md）

扁平列表，每页一行：[Title](path) — 一行摘要。按分类分组（与子目录匹配）。不使用表格，不使用 emoji。

# Knowledge Index

## Category A
- [Page Title](category-a/page-slug.md) — one-line summary

## Category B
- [Page Title](category-b/page-slug.md) — one-line summary

分类名称和结构是灵活的 — 遵循索引中已有的组织方式，或根据内容创建新分类。

日志格式（knowledge/log.md）

仅追加，最新在底部：

## [YYYY-MM-DD] ingest | Page Title
## [YYYY-MM-DD] synthesize | Page Title

指南

• 文件命名：小写 kebab-case（例如 machine-learning.md）
• 每页一个主题：在页面之间链接，而不是重复
• 更新，而非重复：如果页面已存在，更新它
• 交叉引用：每个页面都应链接到相关页面；保持知识图谱连通
• 索引是强制性的：任何更改后始终更新 knowledge/index.md
• 保持简洁：捕捉精华，而非复制整个来源
• 回复中使用完整路径：在对话回复中引用知识文件时，使用从工作区根目录开始的完整路径（例如 [Title](knowledge/<category>/<slug>.md)），而不是相对路径。相对路径仅用于知识页面内部的交叉引用。
• 引用来源：基于知识页面回答时，包含相关页面的链接，以便用户进一步探索。