新手入门 Basic Memory 时：从访谈…

当用户初次使用 Basic Memory、想搭建或整理个人知识库并让 AI 助手跨会话记住上下文时，用访谈和分阶段构建把零散笔记变成有 schema、observations、指令笔记和启动路由器的知识图谱。

适用场景

解决思路

1. 用任意 LLM 或助手平台执行本技能；遇到平台特定设置（system prompts、project instructions）时，先判断你所在环境支持什么，再按 `references/assistant-setup.md` 的通用模式适配。
2. 理解并利用 Basic Memory 的本质：它是将被解析成知识图谱的 markdown 文件；无结构笔记价值有限，复合价值来自 schema、observations/relations、instruction notes、startup router 四件事。
3. 从一开始安装 schema：为每种笔记类型定义字段，使 task/contact/expense 等笔记外观一致且可结构化查询。
4. 从一开始安装 observations 和 relations：用 `- [status] active` 这类分类事实和 `- depends_on [[Other Note]]` 这类带类型链接，把散文变成图。
5. 从一开始安装 instruction notes：把系统规则写进系统内部，作为助手会话启动时加载的笔记，让知识库自描述。
6. 从一开始安装 startup router：写一个很小的笔记，告诉任何平台上的任何助手，每种任务应加载什么。
7. 遵守两个任何规模都不可选的底线：蓝图中的每种笔记类型都必须有 schema；每条写入的笔记都必须带 Observations 段，且至少有一条 `[category]` 事实。
8. 为轻量使用缩减设计时，可以砍文件夹、indexes 和 required fields，但绝不砍 schema 本身，也绝不砍 observations。
9. 认识到一字段 schema 和一行 observation 只花几秒；把结构改造到数百条无结构笔记上才是本技能要避免的失败模式。
10. 用平实语言对话，因为用户可能没听过 schema、observation、frontmatter、knowledge graph，也不需要学会这些词就能受益。
11. 在概念变得相关时再用平实语言介绍：schema 是「让同类笔记保持一致的模板，从而能可靠回答『哪些逾期了？』」；observations 是「笔记上的关键事实，打上标签以便日后查找」；relations 是「笔记之间的链接，让一件事引出下一件」。
12. 明确告诉用户：他们永远不用写语法；`[category]` 行、wiki-links 和 validation 都由你在底层处理，他们只需说话。
13. 一次只讲一个概念，并且只在该概念值得出现时讲；如果发现自己一口气定义三个术语，就停下来，改用他们的数据构建一个例子，例子比定义更能教学。
14. 按工作流概览执行：Phase 0 Preflight → Phase 1 Interview → Phase 2 Blueprint → Phase 3 Build → Phase 4 Assistant setup → Phase 5 Teach → Phase 6 Grow。
15. 不要跳过 Phase 2 与 Phase 3 之间的审批门；构建错误结构比什么都不构建更糟，因为用户之后还得忘掉它。
16. Phase 0 先确认 Basic Memory 工具可用：`write_note`、`read_note`、`search_notes`、`list_directory`，最好还有 `schema_infer`/`schema_validate`；若不可用，停止并先帮助用户连接 Basic Memory。
17. Phase 0 列出项目：调用 `list_memory_projects`，询问要在哪个项目构建，或是否创建新项目。
18. Phase 0 记住：后续每次调用都必须显式传入该项目；混项目写入是最常见且痛苦的设置错误之一。
19. Phase 0 检查已有内容：在根目录用 `list_directory`，depth 2。
20. Phase 0 若项目为空：greenfield，正常进行。
21. Phase 0 若只有少量零散笔记：正常进行，并计划在 Phase 3 把已有笔记并入新结构。
22. Phase 0 若已有大量内容：这是重构而非 onboarding；仍可用本技能，但 Phase 1 改为「什么有效、什么无效」，Phase 2 必须在移动任何东西前先映射 old → new 位置。
23. Phase 0 不确定时查实时文档：Basic Memory 文档可由 agent 读取；抓取 `https://docs.basicmemory.com/llms.txt` 获取索引，并通过 `raw/....md` URL 抓取任意页面为干净 markdown，例如 `raw/reference/mcp-tools-reference.md`、`raw/concepts/schema-system.md`。
24. Phase 0 记住：工具名和参数会演进；当本技能与文档冲突时，以文档为准。
25. Phase 1 访谈时一次只问一个问题，用对话方式；绝不要甩出一墙问题。
26. Phase 1 询问 domains：他们想跟踪什么？如果有想法，就每个深入问：具体跟踪什么、多久一次、什么算完成。
27. Phase 1 若他们完全没想法，提供具体菜单并问哪些有共鸣（多选）。良好起步 domains 大致按广泛吸引力排序：Tasks & projects、Notes & journal、People & contacts、Research、Finances、Procedures、Health & habits、Assets。
28. Phase 1 对用户选择的每个 domain，在提出蓝图前阅读 `references/domain-playbooks.md`，其中有 starter kit：文件夹、schema、命名约定和示例笔记。
29. Phase 1 询问 volume and cadence：每周 5 条笔记的系统与每周 50 条不同；轻量使用 → 更少文件夹、更少 required fields。
30. Phase 1 每个 domain 要一个真实例子：「说说你现在手上的一项任务」/「你付的一个订阅」；这些会在 Phase 3 变成 seed notes，并让后续阶段具体而非假设。
31. Phase 1 询问他们以前试过什么；如果之前系统失败，找出原因，并针对该失败做设计。
32. Phase 1 即使他们兴奋地想选六个 domains，也从 2–3 个开始；能运转的小系统会成长，庞大的空脚手架会死。把 deferred domains 记下来供 Phase 6 使用。
33. Phase 2 在尚未阅读时先读 `references/conventions.md` 和 `references/schema-guide.md`。
34. Phase 2 在聊天中呈现一个文档（此时还没写到任何地方），包含：带每个文件夹一行用途的完整建议目录树；除 domain 文件夹外包含 `Schemas/`、`Templates/` 和 `Instructions/`（或 `Meta/`）文件夹。
35. Phase 2 文档包含 schemas table：每种笔记类型一行，列出 schema name、note_type、required observations、optional observations、status enum values。
36. Phase 2 文档包含 naming conventions：每种笔记类型的 title format、date formats、status vocabularies。
37. Phase 2 文档包含 instruction notes：startup router 加上每个 domain 一个 instruction note（结构见 `references/conventions.md`）。
38. Phase 2 文档包含他们将遵守的 discipline rules：search before create、exact-casing paths、changelog rows、index updates、bidirectional links；每条都附一行 why。
39. Phase 2 带他们过一遍，邀请反驳并迭代。
40. Phase 2 按他们的答案缩放，但缩放只意味着更少文件夹、更少 indexes、更少 required fields，绝不放弃 schemas 或 observations（见不可选底线）。
41. Phase 2 在进入 Phase 3 前获得明确批准「yes, build it」。
42. Phase 3 按顺序构建，因为后面的项引用前面的项。
43. Phase 3 构建 schemas：放到 `Schemas/` 文件夹，每种类型一条笔记，使用 `validation: warn`；语法见 `references/schema-guide.md`。
44. Phase 3 构建 templates：放到 `Templates/`，每种笔记类型一个，与 schema 完全匹配。
45. Phase 3 构建 instruction notes：先写每个 domain 的规则笔记，最后写 startup router（它链接所有内容）；完整结构和示例见 `references/conventions.md`。
46. Phase 3 构建 index notes：给需要 index 的 domain 各写一个（目录；不是每个 domain 都需要）。
47. Phase 3 若走重构路径，迁移已有笔记：在 seed 任何东西之前，执行 Phase 2 批准的 old → new 映射；把每条已有笔记移到新家，设置 note type，添加其 schema 要求的 observations，并在笔记落位时更新 indexes。
48. Phase 3 迁移时归档不适合的内容，绝不删除。
49. Phase 3 只要根目录还有任何未整理内容，Phase 3 就不算完成。
50. Phase 3 写 seed notes：每个 domain 用 Phase 1 收集的例子写 2–3 条真实笔记。
51. Phase 3 绝不用占位数据做 seed；真实笔记能教格式且立即可用，假笔记是用户必须删除的噪音。
52. Phase 3 验证：对 seed notes 和任何迁移的笔记运行 `schema_validate`；修复它标出的问题。
53. Phase 3 读回 router 和一条 instruction note，确认链接能解析。
54. Phase 3 全程遵守 `references/conventions.md` 中的 write discipline；最重要的是：创建任何东西前先搜索，使用精确文件夹大小写，并留意写入结果中出现重复后缀的 permalinks（`-1`、`-2`）。
55. Phase 4 认识到：只有助手每个会话都加载规则，系统才有效；否则只有用户知道约定，这违背目的。
56. Phase 4 阅读 `references/assistant-setup.md`，并设置（或把精确文本交给用户）一个 persistent instruction stub：在平台提供的任何始终加载机制（project instructions、custom instructions、system prompt、agent context file）中放一个短块，内容大意是「Before any knowledge-base work, read the startup router note in project X and follow its dispatch table.」
57. Phase 4 判断你所在平台提供什么机制，并给出具体、按平台的步骤；若无法判断平台，就展示通用 stub 和参考文件中的常见放置位置。
58. Phase 4 以参考文件中描述的验证测试结束：模拟一个全新会话；确认 router 被加载并遵循。
59. Phase 5 通过用他们的数据动手做来教学，而不是讲课。
60. Phase 5 运行 capture 练习：「说说今天发生的一件事」→ 一起创建笔记，填充时讲解 schema 字段和 observations。
61. Phase 5 运行 retrieve 练习：让他们要东西（「我手上有什么？」「关于 X 我知道什么？」）→ 演示 `search_notes` 以及通过 `memory://` 链接读取；解释对名称的 title-search 与 semantic search。
62. Phase 5 运行 update 练习：改变 status、追加 observation、添加 changelog row——展示 `edit_note` 用于定向修改，以及整篇覆写。
63. Phase 5 运行 connect 练习：在他们两条笔记之间添加 relation；展示 `build_context` 如何遍历图。
64. Phase 5 然后把 cheat-sheet note 写进他们的 KB（`Instructions/` 文件夹）：列出他们能说的短语、每句话会发生什么、核心规则；这条笔记是给他们人的，不是给助手的。
65. Phase 6 在收尾时打开后续扩展：建议 2–3 个具体扩展，来自 deferred Phase 1 domains 或所建系统的自然邻居（建了 tasks → 建议 meetings；建了 finances → 建议 renewals calendar；建了 research → 建议 reading log）。
66. Phase 6 每个扩展都用「when you're ready」框定；绝不要构建未请求的东西。
67. Phase 6 建议 maintenance cadence：定期（每周/每月）review，用 `schema_diff` 查漂移，扫描重复或孤儿笔记，清理陈旧 statuses。
68. Phase 6 若平台支持 scheduled/recurring tasks，主动提出设置。
69. Phase 6 遵守 evolution rule：当某个约定开始让人不舒服时，修改 instruction note（带 changelog row），不要无声偏离；规则在系统中保持真实，系统才能保持自描述。
70. 参考文件：在 Phase 2 前读 `references/conventions.md`（startup router anatomy、instruction notes、changelogs、indexes、linking、write discipline、failure modes）。
71. 参考文件：在 Phase 2 前读 `references/schema-guide.md`（Picoschema syntax、observations、relations、validation workflow）。
72. 参考文件：Phase 1–2 对用户选择的每个 domain 读 `references/domain-playbooks.md`（starter folders、schemas、naming、example notes per domain）。
73. 参考文件：Phase 4 读 `references/assistant-setup.md`（persistent-instruction stub patterns per platform + verification test）。
74. 当伴随技能已安装时，交接而不是重复：`memory-notes` 和 `memory-schema` 负责笔记写作和 schema 机制；`memory-tasks` 负责 agent-side task tracking；`memory-lifecycle` 负责 restructure path 上的归档；`memory-defrag`/`memory-curate`/`memory-reflect` 负责 Phase 6 维护节奏；`memory-continue` 负责从图恢复工作，这是 onboarding 后自然要教的第一件事。

适用边界 · 注意事项

• 没有安装或无法连接 Basic Memory 工具时（`write_note` 等不可用），不适用；应先停止并帮助连接 Basic Memory。
• 用户已有大量现有内容时属于重构场景，必须先做 old → new 映射并归档不匹配内容；若不能接受迁移或归档，不宜按新手 onboarding 直接套用。
• 用户完全拒绝 schema/observations 的最低结构，或只需要一次性临时记笔记、不想让助手跨会话加载规则时，不适用；本技能价值来自可查询图与自描述规则。