| name | wiki-curate |
| description | 用于对 vault 做内容策展——基于 Karpathy LLM Wiki 三层架构执行 Scan → Ingest → Curate → Lint 四阶段。触发语：/wiki-curate、scan、ingest、curate、lint、「整理我的笔记库」、「整理 vault」、「整理 LLM Wiki」。绝不改只读目录原文（07-Ideas/、10-Work/、SpecIn/），不写 wiki-struct 受管块；结构层（Home 树/分区页/地图）→ wiki-struct。 |
Wiki Curate
配置说明：vault 的结构配置存在家目录注册表 ~/.config/obsidian-wiki/configs/<库名>.json（按 active 库解析；未注册则回退库内 <vault>/.wiki/config.json）。schema 见本插件根 config.example.json。脚本仍通过 --vault "<vault 根路径>" 指定 vault，结构由注册表/回退提供。
脚本定位：脚本装在本 skill 的 scripts/ 目录下。用本 skill 的 base directory 把相对路径 scripts/<脚本名>.py 拼成绝对路径来跑（不解析环境变量、不 find 缓存）。
把目标 vault 长期维护成 Karpathy 风格的 LLM Wiki——可累积、可检索、可双链浏览的本地知识库。
设计依据
本 skill 基于 Andrej Karpathy 在 2026-04 发布的 LLM Wiki 方法论。核心思想：
- 不靠 RAG 反复检索原始材料，而是让 LLM 增量维护一个结构化、持久的 Markdown wiki。
- 三层架构：Sources（只读）/ Wiki（LLM 写）/ Schema（规约）。
- 三类操作：Ingest（吸纳）/ Query（提问）/ Lint（健康检查）。
- 关键产物：index（带摘要的目录） + log（append-only 操作日志）。
- 哲学：人选材+提问，LLM 摘要+归类+补链+记账+体检。
详细方法论与原文出处见 references/karpathy-llm-wiki.md。
Vault 三层映射
| 层 | 当前 vault 中的目录 | 谁写 |
|---|
| Raw sources（只读） | 07-Ideas/、10-Work/、SpecIn/ | 用户写，LLM 绝不修改 |
| Raw sources（可归档） | 99-Inbox/、Clippings/ | 用户放入，LLM ingest 后用户确认可移动 |
| 参考资料 | 03-Memo/、Database/、_scaffold/ | 用户维护，LLM 仅引用 |
| Wiki | 00-Index/（结构归 wiki-struct）、01-Concepts/、02-Models/、04-Tools/、05-Workflows/、06-Prompts/、08-Sources/、09-Journal/ | LLM 增量写入与维护 |
| Schema | obsidian-wiki/{wiki-curate, wiki-struct}/ | 人类制定 |
三条硬红线（必须遵守）
完整规则与边界情况见 references/readonly-dirs-policy.md。要点：
| 目录 | 永远不做 | 可以做 |
|---|
07-Ideas/ | mv / rm / rename / 重写正文 / 修 frontmatter | 在相关内容笔记正文补 [[..]] 双链；在 01-Concepts/ 提炼通用概念 |
10-Work/ | mv / rm / rename / 复制敏感字段到 Wiki / 批量改 MEMORY.md | 提炼可公开概念到 01-Concepts/（按用户启动、逐个确认） |
SpecIn/ | mv / rm / rename / 改写 specode 工作流文档（requirements.md / design.md / tasks.md 等） | 在相关内容笔记补链接；知识沉淀交 specode 的 /specode:distill |
敏感子目录更严格：10-Work/权限申请/、10-Work/系统/、99-Inbox/账号/、99-Inbox/激活/ 只做路径级索引（"账号/Docker.md - 容器镜像账号"这种粒度），不读取或摘要正文。
不写 wiki-struct 受管块：00-Index/Home.md、各一级目录 README.md、00-Index/<目录>.md 分区页的 <!-- wiki-struct:tree ... --> 块归 wiki-struct。ingest/curate 只改内容笔记正文（用途/标签/双链）和文件归属目录；结构由用户跑 /wiki-struct apply 自动收。
不写遗留知识库产物：10-Work/知识库/<系统>/ 下的知识文档与 MEMORY.md 是已剥离的 spec-distill 的历史产物，保留只读；新沉淀走 specode 的 /specode:distill（写到各项目 knowledge-base/，不再写 vault）。
写作规范
完整规范见 references/writing-conventions.md。要点：
- 中文优先：目录说明、笔记标题、标签、摘要、用途段一律中文。保留业界通用英文词（LLM、RAG、API、MCP、SDK、CLI、Claude Code、Obsidian 等）。
- 必含"用途"段：
01-Concepts/ ~ 08-Sources/ 下每篇笔记都要有 ## 用途 段，说明它解决什么问题、应该从哪些索引进入。
- 双链用 Obsidian wikilink：
[[笔记]] 或 [[路径/笔记|显示名]]。不要用 markdown link [文本](路径.md) 写内部链接——会绕过反链系统。
- 标签：说明性标签中文（
概念、架构、日记），命名空间标签可保留 LLM/wiki。
- frontmatter 必填：
类型、状态、标签、更新。
- 来源外部链接：用普通 markdown link 并注明访问日期。
模板见 references/note-templates.md。
触发命令路由
| 命令 | 行为 |
|---|
/wiki-curate | 等价 scan |
/wiki-curate scan | 内容健康侦察：跑 python3 scripts/lint.py lint（确定性检查）+ 列待 ingest 候选 + 最近新增，输出 00-Index/_system/curate-report.md；结构/坏链见 /wiki-struct check |
/wiki-curate ingest <path> | 把指定一个或多个文件吸纳进 Wiki（写摘要/挂索引/补双链），通常指向 99-Inbox/、Clippings/ 下一篇；完成后提示跑 /wiki-struct apply |
/wiki-curate ingest-all | 批量 ingest 上述目录下的待办候选，逐篇向用户确认 |
/wiki-curate curate | 内容策展：补缺失"用途"、改英文说明性标签为中文、在相关内容笔记正文补 [[..]] 修复孤儿双链；不碰受管块 |
/wiki-curate lint | 内容健康检查，跑 python3 scripts/lint.py lint（缺用途/重复 basename/孤儿/frontmatter 缺字段）+ LLM 判断过时/矛盾，输出 00-Index/_system/lint-report.md；坏链项见 /wiki-struct check |
/wiki-curate log | 显示 wiki-log.md 最近 20 行操作记录 |
/wiki-curate help | 显示本表格 |
未指定子命令时按 scan 处理，并向用户提议下一步。
spec 沉淀已迁移到 specode 插件的 /specode:distill <slug>（v2.0.0 剥离；写到各项目 knowledge-base/，不再写 vault）。
四阶段工作流
Scan（侦察）
不动任何笔记，只产报告。
- 跑
python3 scripts/lint.py lint --vault "<vault>"（确定性内容体检：缺"用途"段、重复 basename、孤儿无反链、frontmatter 缺字段）。
- 列 待 ingest：
99-Inbox/、Clippings/ 下尚未在 wiki-log.md 留过 ingest 记录的文件。
- 列 最近新增：mtime 在最近 N 天（默认 7 天）的 Wiki 区笔记。
- 写报告到
00-Index/_system/curate-report.md，结构：概览 → 内容健康摘要 → 待 ingest → 最近新增 → 建议动作。
- 结构漂移与坏链见
/wiki-struct check，本阶段不处理。
- 向用户汇报概览数字 + 最值得动手的 3 件事，等指令再进下一阶段。
Ingest（吸纳）
对单篇新材料按以下顺序：
- 读源：Read 完整读这篇笔记。
- 判定类型：概念 / 实体（模型、工具）/ 工作流 / 来源 / 日记 / 备忘。
- 判定归属：
- 概念 →
01-Concepts/
- 模型 →
02-Models/
- 工具 →
04-Tools/
- 工作流 →
05-Workflows/
- 提示词 →
06-Prompts/
- 外部资料摘要 →
08-Sources/
- 日记 →
09-Journal/
- 备忘（敏感配置）→
03-Memo/
- 决定动作：
- 全新主题 → 用
references/note-templates.md 模板新建笔记，写入内容笔记正文（用途/摘要/双链）。
- 已有主页 → 追加一节，注明日期和来源链接。
- 仅元数据级（如服务器备忘）→ 只在
03-Memo/ 追加一行。
- 放对 Wiki 目录：把笔记写入判定好的 Wiki 目录；不手改分区页——分区页由 wiki-struct 受管块维护。
- 补双链：在新笔记或追加段落里加
[[相关笔记]]；如果相关笔记已存在，进入该笔记追加引回双链。
- 记录日志：append 一行到
00-Index/_system/wiki-log.md：
- YYYY-MM-DD HH:MM ingest <源路径> -> <wiki 路径> (类型: xxx)
- 是否移动源文件：
99-Inbox/、Clippings/：ingest 完成后，提示用户确认移动；用户批准后移动到 Wiki 目录或归档。07-Ideas/、10-Work/、SpecIn/ 的文件：永远不移动。
- 提示结构更新：完成后提示用户跑
/wiki-struct apply 让结构树自动收录新笔记。
Curate（策展）
对已有 Wiki 内容做整理。
- 补"用途"段：扫描
01-Concepts/ ~ 08-Sources/ 下缺失 ## 用途 的笔记，按 vault 上下文补写并标记 状态: 草稿，让用户复核。
- 统一标签：英文说明性标签（
architecture、daily）改为中文（架构、日记），保留 LLM/wiki。
- 修复孤儿双链：把 lint 报告里的孤儿逐篇找到相关内容笔记正文，在正文补
[[孤儿笔记]] 语义双链，不是往分区索引加行（分区索引是 wiki-struct 受管块）。
- 不碰受管块：
<!-- wiki-struct:tree ... --> 块与分区页结构由 wiki-struct 维护；curate 绝不手动编辑这些部分。
- 每次修改都写 log：append 到
wiki-log.md。
Lint（健康检查）
内容健康体检，专注内容笔记质量，不检查结构/坏链（见 /wiki-struct check）。
确定性检查（python3 scripts/lint.py lint 产出）：
- 缺"用途"段：警告级——
01-Concepts/ ~ 08-Sources/ 下缺 ## 用途 的笔记。
- 重复 basename：警告级——全库（排除
skills/）同 basename 出现在多目录。
- 孤儿（无反链）：警告级——
01-Concepts/ ~ 08-Sources/ + 09-Journal/ 下从未被任何笔记引用的笔记。
- frontmatter 缺字段：提示级——
01-Concepts/ ~ 08-Sources/ 下缺 类型/状态/标签/更新 任一字段。
LLM 判断项（lint-checklist.md 指导）：
- 过时声明：提示级——含具体版本号/价格/日期，且
更新 字段早于半年。
- 矛盾对：提示级——相同 H1，结论不同。
输出 00-Index/_system/lint-report.md，按类别分节。坏链与结构漂移见 /wiki-struct check，lint 不报这两项。
产物清单
本 skill 维护或创建的文件：
00-Index/_system/
├── wiki-log.md ← append-only 操作日志（ingest/curate/lint 均写入）
├── curate-report.md ← scan 阶段产物
└── lint-report.md ← lint 阶段产物（python3 scripts/lint.py lint 生成）
- 结构产物（Home 树、分区页、README、地图）归 wiki-struct。
- 知识库产物（
10-Work/知识库/<系统>/ 知识文档与 MEMORY.md）为已剥离的 spec-distill 遗留产物，保留只读、不再维护。
操作约束
- 改前必读：编辑任何
.md 前先 Read。
- 写后必写日志：任何创建/修改/移动笔记的动作都在同一回合 append
wiki-log.md。
- 批量操作必备份：超过 10 个文件的批量改写前，tar 备份到
~/Library/Caches/wiki-curate-backup-<ts>/。
- 优先用 Edit/Write 而不是 sed/mv：vault 在外置盘、含中文路径与空格，文件操作要稳定可回溯；mv 涉及只读目录直接拒绝执行。
- 不联网：不把 vault 内容发到外部 LLM、笔记同步、向量库；只用本机 Claude Code 上下文。
- 任何破坏性动作前 AskUserQuestion：移动文件（仅限非只读目录）、删除孤儿页、合并重复笔记，必须列出来源与目标让用户批准。
与用户对话的节奏
- 每个阶段开始前用一句话说"我现在要做 X"，结束后给一行摘要。
- Scan 完成后汇报：(a) 概览数字，(b) 最值得动手的 3 件事，等指令再进 ingest/curate/lint。
- 每个 ingest 或 curate 动作前用一句话说"我要把 X 加到 Y、补 Z 链接"再动手。
- 不要默认进下一阶段；用户驱动节奏。
问答检索流程
当用户基于本地笔记提问时，不要全库 grep，按索引链路检索：
- 先读
00-Index/Home.md，找到全局入口。
- 根据问题选分类索引（如
00-Index/01-Concepts.md、00-Index/04-Tools.md、00-Index/10-Work.md）。
- 如果分类索引指向项目索引（如
10-Work/知识库/<子项目>/MEMORY.md），先读项目索引，再读原始笔记。
- 只读取回答所需的链接笔记。
- 回答时说明关键依据来自哪些笔记。
参考文档（references/）
karpathy-llm-wiki.md：方法论摘要、原文出处、术语与本 vault 的对应；三层映射含 wiki-struct 分工writing-conventions.md：完整写作规范——目录模型、笔记类型、标签、frontmatter、中文化原则；含"index/分区页/Home 由 wiki-struct 受管块维护，curate/ingest 不手改"的职责边界note-templates.md：索引/概念/实体/工作流/来源/日记的标准模板；spec 知识沉淀模板见 specode 插件 skills/distill/references/doc-template.mdreadonly-dirs-policy.md：三个只读目录（07-Ideas/、10-Work/、SpecIn/）的详细规则、敏感子目录处理、衍生页写作规则；10-Work/知识库/ 为遗留产物、只读lint-checklist.md：Lint 阶段内容健康检查清单（对齐 scripts/lint.py 四项确定性检查 + LLM 判断项）；坏链与结构漂移见 /wiki-struct check
