knowledge

Mental Model

Knowledge is for deliberate capture of reference material. Unlike memory (which extracts info from conversation), knowledge is explicit: user asks to save something.

Trigger Patterns

User Intent	Action	Destination
"Save this link"	Store URL	bookmarks.jsonl
"Make a note about X"	Create note	notes/YYYY-MM-DD_topic.md
"Remember this code pattern"	Save snippet	snippets/{lang}/

What Goes Where

.knowledge/
├── bookmarks.jsonl           # URLs, articles, docs
├── notes/
│   └── YYYY-MM-DD_topic.md   # Meeting notes, ideas, summaries
└── snippets/
    ├── typescript/           # Language-specific patterns
    ├── python/
    └── shell/

Entry Schemas

Bookmark:

{"id":"bm_{{timestamp}}","url":"{{URL}}","title":"{{page title}}","tags":["{{keywords}}"],"savedAt":"{{ISO8601}}"}

Note (Markdown + YAML):

---
title: {{Topic}}
date: {{YYYY-MM-DD}}
tags: [{{keywords}}]
---

# {{Topic}}

{{content}}

Snippet:

// @title: {{Pattern Name}}
// @tags: {{keyword1}}, {{keyword2}}
// @created: {{YYYY-MM-DD}}

{{code}}

Anti-Patterns (NEVER)

• Don't save transient information (today's weather, temporary URLs)
• Don't duplicate - check if already exists before saving
• Don't save without user's explicit request (use memory skill for that)

Action Pattern

User says "保存这个链接" or "Save this":

1. Extract URL, title, context
2. Generate relevant tags
3. fs_write to appropriate destination
4. Confirm what was saved