Use this skill when the user wants to save, retrieve, review, or reuse long-term notes and compact knowledge. Trigger for phrases like “笔记：…”, “保存到知识库”, “今日笔记”, “查找我以前记过的内容”, “根据以前的笔记回答”, “保存这段分析”, “抓取网页并存起来”, or “导入文档做沉淀”. Prefer structured JSON date lookup first, then compact semantic recall, and only read raw text when needed. Do not use for general chat that does not involve saving or retrieving prior memory.
Provide a stable long-term memory workflow with three layers:
This skill is for repeatable note and knowledge workflows, not for general open-ended chat.
Use this checklist.
agent-memory directory.getget-rawPrimary actions:
notenotes-todaynotes-fetchnotes-extractFull dispatcher actions are documented in references/action-reference.zh-CN.md.
今日笔记 is a structured date query, not a semantic search query.Always validate these points before finishing:
config/settings.json exists and is readable.raw/ and index/ are writable.notes-today and get-raw still work when Qdrant is disabled.rebuild-index is run, catalog.json is rebuilt from JSONL and Qdrant recall rebuild is best-effort only.For local verification, use the test suite and package validator described in README.md and references/examples.zh-CN.md.
Use compact structured JSON for command outputs.
Default response patterns:
{ ok, action, record }{ ok, action, items }{ ok, action, hits }{ ok, action, extraction }{ ok, action, ... }Read these files only when needed:
references/action-reference.zh-CN.md when you need the full action list, argument forms, or slash-command mapping.references/architecture.zh-CN.md when you need storage design, path resolution, recovery, or Qdrant fallback behavior.references/examples.zh-CN.md when you need concrete Chinese usage examples, test commands, or install verification steps.