Back to Details

knowledge-wiki

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Knowledge Wiki

知识维基

Maintain a persistent, structured knowledge base in the 
knowledge/
directory.
在
knowledge/
目录中维护一个持久化的结构化知识库。

Core Operations

核心操作

1. Ingest — User shares an article, document, or resource

1. 导入 — 用户分享文章、文档或资源

  1. Read and understand the source material
  2. Extract key facts, insights, and structured knowledge
  3. Determine the appropriate subdirectory:
    • Read 
      knowledge/index.md
      to see existing categories
    • If a matching category exists, follow that structure
    • If not, create a new subdirectory with a clear name
  4. Create the knowledge page: 
    knowledge/<category>/<slug>.md
  5. Update 
    knowledge/index.md
    and append to 
    knowledge/log.md
  1. 阅读并理解源材料
  2. 提取关键事实、见解和结构化知识
  3. 确定合适的子目录：
    • 阅读
      knowledge/index.md
      查看现有分类
    • 若存在匹配分类，遵循该结构
    • 若不存在，创建一个名称清晰的新子目录
  4. 创建知识页面：
    knowledge/<category>/<slug>.md
  5. 更新
    knowledge/index.md
    并追加到
    knowledge/log.md

2. Synthesize — Conversation produces valuable structured knowledge

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

  1. Create a knowledge page under the appropriate category
  2. Update related pages with cross-references
  3. Update 
    knowledge/index.md
    and 
    knowledge/log.md
  1. 在对应分类下创建知识页面
  2. 更新相关页面并添加交叉引用
  3. 更新
    knowledge/index.md
    和
    knowledge/log.md

3. Query — User asks about accumulated knowledge

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

  1. Check 
    knowledge/index.md
    (already in your context) for relevant pages
  2. Read specific pages with the 
    read
    tool
  3. Supplement with 
    memory_search
    if needed
  1. 查看
    knowledge/index.md
    （已在上下文内）寻找相关页面
  2. 使用
    read
    工具读取特定页面
  3. 必要时借助
    memory_search
    补充信息

Page Format

页面格式

markdown
undefined
markdown
undefined

Page Title

页面标题

Source: <URL or description of the original material>
Content here. Cross-reference related pages with markdown links: Related Page
来源：<原始材料的URL或描述>
内容在此处。使用Markdown链接交叉引用相关页面： 相关页面

Key Points

要点

  • ...
  • ...

Related

相关内容

  • Page A — how it relates
  • Page B — how it relates

The `> Source:` line records where the knowledge came from (URL, document name, conversation, etc.). Always include it when the material originates from a specific source.

Cross-references build a knowledge graph. When creating or updating a page, link to related pages and update those pages to link back. **Only link to pages that already exist** — if a concept deserves its own page, create it first, then add the link.
  • 页面A — 关联说明
  • 页面B — 关联说明

`> 来源：`行记录知识的来源（URL、文档名称、对话等）。当材料来自特定来源时，务必包含该行。

交叉引用构建知识图谱。创建或更新页面时，链接到相关页面并更新这些页面以反向链接。**仅链接到已存在的页面**——如果某个概念值得拥有独立页面，先创建该页面，再添加链接。

Index Format (
knowledge/index.md
)

索引格式（
knowledge/index.md
）

Flat list, one line per page: 
[Title](path) — one-line summary
. Group by category (matching subdirectories). No tables, no emoji.
markdown
undefined
扁平列表，每页一行：
[标题](路径) — 一行摘要
。按分类分组（与子目录匹配）。不使用表格，不使用表情符号。
markdown
undefined

Knowledge Index

知识索引

Category A

分类A

  • Page Title — one-line summary
  • 页面标题 — 一行摘要

Category B

分类B

  • Page Title — one-line summary

Category names and structure are flexible — follow whatever organization already exists in the index, or create new categories based on the content.
  • 页面标题 — 一行摘要

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

Log Format (
knowledge/log.md
)

日志格式（
knowledge/log.md
）

Append-only, newest at bottom:
markdown
undefined
仅追加，最新内容在底部：
markdown
undefined

[YYYY-MM-DD] ingest | Page Title

[YYYY-MM-DD] ingest | 页面标题

[YYYY-MM-DD] synthesize | Page Title

[YYYY-MM-DD] synthesize | 页面标题

undefined
undefined

Guidelines

指南

  • File naming: lowercase kebab-case (e.g. 
    machine-learning.md
    )
  • One topic per page: link between pages rather than duplicating
  • Update, don't duplicate: if a page exists, update it
  • Cross-reference: every page should link to related pages; keep the knowledge graph connected
  • Index is mandatory: always update 
    knowledge/index.md
    after any change
  • Be concise: capture essence, not copy entire sources
  • Full paths in replies: when referencing knowledge files in conversation replies, use the full path from workspace root (e.g. 
    [Title](knowledge/<category>/<slug>.md)
    ), not relative paths. Relative paths are only for cross-references inside knowledge pages themselves.
  • Cite sources: when answering based on knowledge pages, include links to the relevant pages so the user can explore further.
  • 文件命名：小写短横线命名法（例如
    machine-learning.md
    ）
  • 每页一个主题：在页面间建立链接而非重复内容
  • 更新而非重复：若页面已存在，直接更新
  • 交叉引用：每个页面都应链接到相关页面，保持知识图谱的关联性
  • 索引必填：任何更改后务必更新
    knowledge/index.md
  • 简洁性：捕捉核心内容，不要复制整个源材料
  • 回复中使用完整路径：在对话回复中引用知识文件时，使用工作区根目录的完整路径（例如
    [标题](knowledge/<category>/<slug>.md)
    ），而非相对路径。相对路径仅用于知识页面内部的交叉引用。
  • 引用来源：基于知识页面作答时，包含相关页面的链接，方便用户进一步探索。