当知识库笔记增多、出现孤立/重复/标签混乱时，用…

适用于需要整理、连接和优化 Basic Memory 知识库中的笔记、关系、标签与目录的场景。

适用场景

解决思路

1. 查找孤立笔记：用 search_notes(query="*", page_size=50) 列出笔记，再逐条 read_note(identifier="note-to-check") 检查其 Relations 部分；Relations 为空或缺失的即为孤立笔记。
2. 处理孤立笔记：根据内容相似度建议关系；询问是否应连接到现有主题；提出用 hub notes 收集相关孤立笔记（见创建索引/中心笔记）。
3. 建议类型化关系：用 read_note(identifier="note-to-analyze") 读取待分析笔记，提取关键术语后用 search_notes(query="...") 搜索相关笔记；根据共享主题、互补内容（问题/解决方案、问题/答案）、顺序（part 1 → part 2）或层级（父概念 → 细节）建议关系。
4. 使用关系类型词汇：relates_to 表示一般主题连接；extends 表示构建或详述；implements 表示实现概念或规格；depends_on 表示需要理解；part_of 表示层级或组成；contrasts_with 表示提出替代观点；inspired_by 表示洞察来源；enables 表示使某事成为可能；也可自定义关系类型，使用描述性动词即可。
5. 添加已确认关系：用 edit_note(identifier="API Design Decisions", operation="append", section="Relations", content="- depends_on [[Rate Limiter]]")。
6. 识别相似/重复笔记：用 search_notes(query="topic keywords") 搜索，比较结果中的相似标题、重叠观察、共享标签、时间戳接近等迹象。
7. 处理重复笔记：合并为单一综合笔记，再用关系重定向被合并者；当一个修订另一个时用 supersedes / updates 链接；通过添加上下文来区分，明确每个笔记的独特焦点。
8. 重定向替代笔记：用 edit_note(identifier="DB Schema v1", operation="append", section="Relations", content="- updates [[DB Schema v2]]") 让旧笔记指向替代它的笔记。
9. 目录组织审查：用 list_directory(dir_name="/", depth=3) 查看目录，寻找过度拥挤目录、单笔记目录、命名不一致、放错位置的笔记；建议将相关笔记分组到主题目录、为大类添加子目录、采用一致命名约定。
10. 移动放错位置笔记：用 move_note(identifier="API Design Decisions", destination_path="architecture/api-design-decisions.md")；permalink 保持稳定，所以 wiki-links 继续解析。
11. 检查标签一致性：用 search_notes(query="*", page_size=100) 并检查标签模式，寻找变体标签（如 architecture vs arch，选择一种并标准化）、未使用标签（只出现在单个笔记且不再有分量）、过度使用的泛化标签（太宽泛无助于发现）、缺失标签（相关笔记缺少明显标签）。
12. 创建索引/中心笔记：发现相关笔记集群后，用 write_note 构建导航中心，设置 title="Architecture Decisions Index"、directory="indexes"、tags=["architecture", "index"]、note_type="index"，content 中包含指向 Decisions、Patterns 的 wiki-links、Observations 和 Relations（如 - indexes [[Architecture]]）。
13. 充实稀疏笔记：用 read_note(identifier="sparse-note") 读取；若缺少 Observations 部分，建议类别；若没有 Relations，建议链接；若没有标签，建议相关标签；若缺少上下文，建议添加背景；用 edit_note 应用。
14. 快速健康检查：1. 统计总笔记数；2. 识别孤立笔记数；3. 用 recent_activity 列出最近修改；4. 检查明显重复；5. 报告目录分布。
15. 深度整理会话：1. Audit：编目所有笔记并识别问题；2. Orphans：处理未链接笔记；3. Relations：建议新连接；4. Duplicates：合并或区分相似笔记；5. Structure：必要时重组目录；6. Index：为主要主题创建中心笔记。
16. 主题聚焦整理：1. 用 search_notes 查找与特定主题相关的所有笔记；2. 用 build_context(url="memory://...") 映射现有关系；3. 识别主题图中的缺口；4. 建议新笔记填补缺口；5. 创建主题索引笔记。
17. 最佳实践：增量工作，不要一次重组全部。
18. 最佳实践：更改前确认，移动、合并或编辑笔记前始终询问。
19. 最佳实践：保留 permalinks；移动笔记可以，改变 permalink 会破坏入站链接。
20. 最佳实践：解释建议，说明关系或合并为何合理。
21. 最佳实践：尊重现有体系，增强用户组织方式，不要强加新分类法。
22. 最佳实践：展示图谱，用 build_context 帮助用户看到笔记如何连接。
23. 示例：当用户说“Help me organize my notes”时，运行健康检查，报告笔记总数、孤立笔记和潜在重复，并询问先处理孤立笔记还是先审查重复。
24. 示例：当用户要求查找应链接到某笔记的笔记时，读取该笔记，搜索相关内容，然后按关系类型建议（如 'REST Best Practices' → relates_to、'Authentication Flow' → implements、'Rate Limiting Decision' → extends），并询问是否添加。
25. 示例：当用户询问相似主题笔记时，分析标题和内容聚类，报告可能重叠项（如 'Auth Flow' 与 'Authentication Design'、'DB Schema v1' 与 'DB Schema v2' 可能需要 supersedes），并询问是否审查。

适用边界 · 注意事项

• 没有 Basic Memory 或等价的 search_notes/read_note/edit_note/list_directory/move_note/write_note/build_context/recent_activity 工具时不适用。
• 整理代理自身记忆文件（如拆分臃肿文件、清理过期条目）应使用 memory-defrag，而不是本技能。
• 不要在未获得用户确认的情况下移动、合并或编辑笔记。