知识库梳理和治理
产品介绍
--- name: zhishikushuli description: "引导用户系统梳理失控的本地知识库（Obsidian / 本地 Markdown），覆盖诊断体检、止血立规、存量分批清理、导航骨架搭建与防复发维护机制。当用户说知识库太乱、笔记越积越多不可控、找不到东西、结构混乱、检索失效、想重构/整理/归档本地笔记库、内容太多不知道怎么管理、不知道怎么分类时使用。先诊断再动手，强调只读体检、归档代替删除、导航与存储分离。" description_zh: "引导式梳理失控的本地知识库（Obsidian/Markdown）：诊断→立规→分批清理→搭骨架→防复发" description_en: "Triage an out-of-control local knowledge base (Obsidian/Markdown): diagnose, stop the bleeding, batch-clean, build navigation, prevent relapse" version: 1.1.0 agent_created: true allowed-tools: Read,Write,Bash,Grep,Glob --- # 知识库梳理（Vault Triage） 引导用户把「越用越乱、找不到东西」的本地知识库，梳理成**可持续、可检索、不靠记忆**的状态。 ## 何时使用 - 用户抱怨知识库太乱 / 文件越来越多 / 不知道放哪 / 搜不到 / 不敢删 - 用户想整理、重构、归档自己的 Obsidian 库或本地 Markdown 文件夹 - 用户感觉"整理过几次又乱了"，需要一套能长期维持的机制 - 用户新建知识库前想避免重蹈覆辙（按此流程的 S0/S2 即可） **不适用**：云端笔记平台迁移（语雀/Notion 间搬家）、从零建设全新库（那是 llm-wiki 的范畴）、纯技术性的双链修复小任务。 ## 核心立场（先讲清，贯穿全程） 1. **失控是常态，不是人品问题。** 知识库天然熵增，梳理的目标不是"永远整齐"，而是"乱得起、找得到、恢复快"。 2. **先诊断，后动手。** 大部分"整理"失败，是因为没分清自己得的是哪种病就开药。 3. **先止血，再清存量。** 立规矩的成本远低于事后整理，从本次对话起的新内容先走新规则。 4. **归档代替删除。** 用户怕丢东西是正常的，Archive 文件夹 + 全库搜索就是"心理安全网"，比"断舍离"更容易坚持。 5. **导航层与存储层分离。** 文件夹只做粗粒度分档，精细导航交给 MOC（地图）+ Dataview 索引 + 搜索，避免把文件夹建到十层深。 6. **克制过度整理。** 分类超过 3 层、维护成本高于收益的整理是新的失控。宁可少分，不可错分。 7. **最小干预承诺。** 不要求用户把文件夹改成 Projects/Areas 这类英文名；默认只动最常用的 20% 存量，其余保持原样；结构改不动的决定权始终在用户手里。 ## 六步工作流 整体按顺序执行；S0-S1 每次必做，S2-S5 依据体检结果取舍。每步先读对应 `references/` 文档再执行。 | 步骤 | 名称 | 解决什么 | 关键产出 | 参考文档 | |---|---|---|---|---| | S0 | 目标对话 | 不知道这个库到底为谁、存什么 | 「库的使命」一句话 | diagnosis.md | | S1 | 体检诊断 | 说不清病在哪 | 体检报告 + 病型画像 + A/B/C 程度分级 | diagnosis.md + scan_vault.py | | S2 | 止血立规 | 只进不出的口子 | 收件箱 + 命名/frontmatter 约定 + 新笔记流程 | obsidian-mechanics.md | | S3 | 存量分批清理 | 历史欠账 | 分批行动计划与执行记录 | clean-batches.md | | S4 | 搭导航骨架 | 靠记忆找文件 | 首页 MOC + 自动索引 | obsidian-mechanics.md + assets/templates | | S5 | 维护机制 | 清了又乱回去 | 例行节奏表 + 防复发约定 | obsidian-mechanics.md | --- ### S0 目标对话（10 分钟，先梳理思路） 动手前先问清楚，这些问题直接决定结构怎么搭： 1. 这个库**服务于什么**？个人成长 / 工作项目 / 写作素材 / 学习笔记，多选可以但最多 3 个主线。 2. 你**最常取用**的内容是什么？怎么找？（搜索 / 文件夹 / 标签 / 双链） 3. 你**最头疼**的时刻是什么？（记了找不到 / 新笔记不知放哪 / 东西太杂不敢删 / 整完又乱） 4. 每周愿意花**多少时间**维护？诚实回答，这决定机制要轻到什么程度。 产出：把答案凝练成一句话使命，例如「这个库服务我的 AI 编程教学：课程内容按主题归档，素材与灵感进收件箱每周五清理一次」。 > 库没有使命，任何结构都是随机结构。如果用户答不上来，帮他收敛到 1-2 个主线，并明确告知"什么都存"的库先从收件箱+归档起步。 ### S1 体检诊断（只读，不动任何文件） 执行顺序： 1. 先读 `references/diagnosis.md`，用其中的**症状自检清单**与用户快速对话，让用户自己描述症状。 2. 运行 `scripts/scan_vault.py <库路径>` 做客观扫描（只读统计：文件数、目录深度、frontmatter 缺失率、孤立笔记、重复文件名、最近修改分布）。 3. 把主观症状与客观数据合并，做**双层诊断**：按 diagnosis.md 的失控画像判定主病型（囤积型 / 结构洁癖型 / 散养型 / 混合型——决定"治什么"）；再按混乱程度判定 A/B/C 级（清爽 / 杂而不乱 / 失控——决定"动多大手术"）。 产出：一份体检小结（可用 assets/templates/health-report 结构），明确： - 三个数字（总笔记数、平均深度、frontmatter 覆盖率） - 主病型 1-2 个（治什么） - A/B/C 程度分级（动多大手术） - 对应路径（见下方「分级路径」） **只读原则：此阶段禁止移动、删除、重命名任何用户文件。** ### 分级路径与授权决策点（S1 之后先对号入座） | 程度 | 客观判据 | 走哪条路 | |---|---|---| | **A 清爽型** | 顶层文件夹 <10、层级 ≤3、搜索基本能命中 | S2 止血 + S4 补 MOC 微调。**不移动任何物理文件**，S3 整段可跳过 | | **B 杂而不乱** | 文件夹多但逻辑自洽、放得下也找得到 | S2 + **元数据映射**（不移动文件，用 frontmatter 打 PARA 属性）+ S4 生成看板/MOC | | **C 失控型** | 重复文件成组多、休眠占比高、经常找不到（脚本实测为准） | 完整 S2→S3→S4→S5。**批次 D 重构前必须先过下方授权决策点** | **授权决策点（C 类且需动顶层结构时，强制）**： 1. 先向用户说明风险与代价：「当前结构可能已失效。建议把现有顶层文件夹整体移入 `!旧结构_Backup`，再新建映射层；您需要投入 1-2 小时迁移高频文件。」 2. **得到用户明确同意后**，才给出迁移方案并执行。 3. 用户**拒绝 → 自动降级为 B 路径**：不移动任何文件，改为打元数据属性 + 建 MOC 兜底。不劝用户接受重构。 > 话术基调（可直接使用）：「我不会要求您把文件夹改成 Projects/Areas 这类英文名。无论改不改，我们只动最常用的那 20% 笔记，剩下的保持原样，绝不破坏您的使用惯性。」 ### S2 止血立规（先让"新内容"不再添乱，约 30 分钟） 新规矩只从**本次对话后**生效，旧文件一律不动，等 S3。 1. **建单一收件箱**：库根建 `00-收件箱/`（或启用 Obsidian 自带"每日笔记"当天兜底）。规则：任何新东西先落收件箱，不允许"顺手放进正式文件夹"。 2. **定命名约定**：选一套即可（如 `YYYY-MM-DD-标题` 或 `标题`），旧文件不强求改。 3. **定 frontmatter 最小字段**：`tags` + `created` 起步（模板见 assets/templates/note-frontmatter），用 Obsidian 模板功能一键插入。 4. **写"新笔记入口流程"**：新笔记 → 落收件箱 → 当天/当周处理（转正式区 or 留收件箱 or 删除）。把这条规则贴到收件箱文件夹的说明文件里，也写进日记模板。 产出：收件箱目录 + 2 个模板文件 + 一段可复制的"使用说明"放进收件箱。 ### S3 存量分批清理（按体检结果决定做不做、做几批） **从易到难、分批执行，每批结束向用户汇报并等确认。** 全部操作细节与判断标准读 `references/clean-batches.md`。 - 批次 A · 死档归档（决策成本最低，先做）：明确过期、已完成、不会再看的 → 移入 `99-归档/`。这一批通常能砍掉 20-40% 存量，立刻建立信心。 - 批次 B · 去重与近似合并：扫描重复文件名/重复标题，合并或互链，不硬删。 - 批次 C · 未消化收藏三选：针对"存了没看"的内容，逐条用 5 秒判断：转正文笔记 / 归档 / 删除。 - 批次 D · 结构重构（仅当 S1 判定为结构病**且程度为 C、并通过授权决策点**才做）：选型见 `structure-patterns.md`，用"先建新骨架目录 → 移动（重命名）→ 原路径留跳转或搜索兜底"的方式迁移，禁止复制粘贴式搬运。用户拒绝授权时**降级为 B 路径**（元数据 + MOC），不移动文件。 安全规则（强制）： - 全程**移动/归档优先，删除需用户逐条确认**。 - 每批最多动 50 个文件以内的小批，批间停下让用户检查。 - 动手前先确认有备份（Obsidian 同步 / Git / 压缩包任一即可），没有就先做一个库级压缩包。 ### S4 搭导航骨架（让"找"不依赖记忆和分类） 目标：让用户以后**搜得到、看得见全貌**，而不是记得住放哪。 1. 首页 MOC：库根放 `Home.md`，用链接把 2-5 个主线 + 收件箱 + 归档 + 常用 MOC 列全（首页模板见 assets/templates/home-moc，MOC 页模板见 assets/templates/moc-template）。 2. 每个主线建一个 MOC 页（如 `_MOC-AI编程.md`），只挂该主线下的主题页与重要笔记。 3. 自动索引（Obsidian）：用 Dataview 按 frontmatter 字段自动列出"最近笔记 / 收件箱待处理 / 某标签下全部笔记"，替代手维护目录。具体写法见 `obsidian-mechanics.md`。 4. 双链卫生：只做轻量修复——给孤岛笔记补 1 个入链（从所属 MOC 挂上），不追求全库图谱完美。 ### S5 维护机制（防复发，机制必须轻到用户愿意长期做） 按用户在 S0 承诺的时间设计，默认给一套"最轻配置"： - **每天 1 分钟**：新笔记落收件箱（除此之外什么都不用做） - **每周 15 分钟**：清空收件箱（转正/归档/删除三选） - **每月 30 分钟**：跑一次 scan_vault.py，只看三个数字有没有恶化 - **每季度 1 小时**：季度体检，重复 S1 的画像判断，重读本技能 S3 批次处理积压 把这张表写进用户的日记模板或库内 `_使用说明.md`。明确告诉用户：**偶尔乱掉没关系，机制会在 15 分钟内把它拉回正轨，这才是可维护的状态。** --- ## 对用户本地库的操作安全规则（全流程强制） 1. **先只读后写入**：任何改动前先完成 S1 扫描与报告。 2. **可逆优先**：一律移动/归档，不删除；确需删除必须逐条列清单等用户确认。 3. **小批执行**：单批操作 ≤50 个文件，批间停下汇报，用户确认后再继续。 4. **先备份**：操作前确认已有备份（Git 提交 / Obsidian 同步 / 压缩包），没有就先创建库级备份。 5. **不碰系统与无关目录**：只操作用户明确指出的库路径，不递归扫用户主目录。 6. **全程可视**：每次执行前列出将受影响的具体路径；执行后展示结果。用户要求查看任何步骤的产出文件时用 present_files 打开。 ## 交付物清单 一次完整梳理结束后，确认以下产物都已给出并说明存放位置： - [ ] 「库的使命」一句话（写进 Home.md） - [ ] 体检小结（三个数字 + 主病型 + A/B/C 程度 + 路径） - [ ] 《映射对照表》（用户习惯词 ↔ PARA 原理，模板见 assets/templates/mapping-table） - [ ] 收件箱 + 模板 + 使用说明（S2） - [ ] 分批清理记录（S3 每批做了什么、动了哪些文件） - [ ] Home.md / MOC / 自动索引（S4，按需） - [ ] 维护节奏表（S5） 所有交付内容用简体中文，结构与话术面向零基础用户，避免术语堆砌。 ## 联系作者 微信: woyaobaofuniubi 公众号: AI共学社ALL
资源信息
许可证信息摘自官方源，可能过时或缺失。商用前请以原仓库的 LICENSE 文件为准。
信息边界说明
本页信息摘自官方文档，仅作技术信息呈现，不代表本站的判断或推荐。价格、配额、可用性以官方最新说明为准。你离开本站后的任何行为（申请 Key、付费、部署、商用），本站不做任何承诺与担保。
同类推荐
搜索引擎
免费增值需申请 Key通过公开搜索URL在16个搜索引擎(7个国内直连+9个国际)中做跨引擎检索、结果去重与多源交叉验证,无需API Key,内置零依赖Python脚本。Use when 用户要求“搜一下/查资料/多找几个来源/核实消息/找公众号文章/排查报错/找论文或开源项目”时。输入自然语言查询词,输出带来源链接与可信度标注的结构化结果。不适用于私有数据检索、批量抓取、需要登录后可见的内容。
ima-skills
需申请 Keyima skills，支持对笔记、知识库的读取、写入和检索等操作，可以帮你随时记录，收入ima智能管理，随时调用，龙虾输出精准懂你，友好的接入了OpenClaw生态，构建你的第二大脑。
web-tools-guide
需申请 KeyMANDATORY before calling web_search, web_fetch, browser, or opencli. Contains required error-handling procedures (web_search failure → must guide user to configure API), fallback chain (opencli CLI covers 70+ sites as structured fallback before browser), and site-specific login URLs. Without reading this skill, you WILL handle failures incorrectly and miss available tools. Trigger on: 搜索/上网/查资料/打开网站/抓取网页/新闻/热点/web search/fetch/browser/opencli.
Aihot Skill Lite
官方标注免费需申请 KeyAI HOT（aihot.virxact.com）中文 AI 资讯查询 Skill，帮助用户获取今日 AI 圈动态、AI 日报、AI 热点、最新 AI 资讯以及 OpenAI、Anthropic、Google 等公司的最新发布信息。
Baidu web search
需申请 Key使用百度AI搜索引擎(BDSE)进行网络搜索。适用于获取实时信息、文档资料或研究课题。
Markdown Converter
官方未说明{"answer":"使用 markitdown 将文档和文件转换为 Markdown。用于将 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML、图片（含 EXIF/OCR）、音频（含转录）、ZIP 压缩包、YouTube 链接或 EPub 转换为 Markdown 格式，以进行 LLM 处理或文本分析。"}
什么是技能
技能（Skill）是封装好的单项能力，比如文字识别、文档摘要、关键词提取。开发者把调用逻辑和提示词打包，使用者像用插件一样加载即可，无需了解底层模型。启枢技能 收录大量技能，可直接试跑或编入方案。