wiki

name	wiki
description	操作个人 Obsidian LLM Wiki：执行 Ingest、Query、Lint、Update、Restructure，管理 wiki todo / idea，并在分享或导出时检查边界。用户提到入库、查 wiki、检查 wiki、更新页面、增删域、wiki todo / idea 或引用 wiki 生成材料时使用。

Wiki Skill

操作用户的多域个人 Obsidian LLM Wiki。负责定位仓库、选择操作分支、加载权威协议并执行工作流。

Contract

按以下边界维护单一事实源：

• 本 skill：意图路由、操作编排、Lint 执行方式和硬防线。
• <WIKI_ROOT>/CLAUDE.md：项目边界、工作流、通用页面契约和全局维护规则。
• <WIKI_ROOT>/sources/CLAUDE.md 与 <WIKI_ROOT>/<知识域>/CLAUDE.md：局部页面类型、字段、正文结构和专属 workflow。

skill 与协议冲突时，以协议为准。不要在 skill 里维护第二份页面契约。

Wiki Root

先解析 skill 软链得到 canonical 实文件路径，再从其所在目录运行 git rev-parse --show-toplevel 定位 WIKI_ROOT。如果失败，向上查找同时含 CLAUDE.md、purpose.md 与 index.md 的目录。不得在入 git 文件中硬编码某台机器的 vault 绝对路径。

Activation

1. 读取 <WIKI_ROOT>/purpose.md、CLAUDE.md 和 index.md。
2. Query：读取 references/wiki-query.md、相关知识域 index.md，再读取最相关页面。
3. Ingest / Update：读取 sources/CLAUDE.md（涉及来源时）、相关知识域 CLAUDE.md 和 index.md。
4. Lint：根据被检查页面的路径读取对应域 CLAUDE.md，再按当前 vault 的实际结构执行检查。
5. Restructure：再读取 references/wiki-structure.md。

渐进式加载限制内容阅读，不限制命令式结构检查。

Intent Routing

用户信号	分支
分享文章/链接并要求处理、入库、ingest	Ingest
查 wiki、询问 wiki 里有什么	Query
lint、检查 wiki、健康检查	Lint
更新或修正已有页面	Update
新增、删除、重命名知识域或调整目录	Restructure
wiki todo / wiki idea	读取对应文件和域规则；写入前取得用户确认
生成公开文章、对外总结、导出材料	Query + 分享边界检查

Operation Execution

• Ingest / Query / Update：按根 CLAUDE.md 的对应工作流执行；页面表示以所属域或 sources/CLAUDE.md 为准。
• Restructure：额外读取 references/wiki-structure.md。只把可路由内容目录当作知识域；sources/ 与 logs/ 是基础设施层。
• Lint：根据当前 vault 实际结构选择 rg、find 等只读命令，检查结构、frontmatter、索引覆盖、日志格式、Wikilink、来源追溯、overview 和跨域一致性。不得依赖固定脚本或假定目录一定非空。默认只报告；只有用户明确要求修复时才修改文件。

Non-Negotiables

• sources/raw/ 只允许新建，不修改已有文件。
• ideas/writing.md、ideas/products.md、todo.md 只有用户确认后才可写入。
• 新增、删除、移动或重命名页面时更新对应 index；仅修改既有页面正文或 frontmatter 时只验证索引覆盖。
• 所有写操作追加 logs/YYYY-MM.md；月度日志本身严格追加，不回改顶部元数据。
• 对外输出检查 share_scope：sensitive 默认不外发，private 需用户确认。
• Query 不得绕过已有 wiki 页面直接凭模型常识回答。
• Ingest 必须基于完整 raw 原文；对不确定事实联网查证。

Verification

写操作交付前至少确认：

• 已声明知识域路由。
• raw 已保存，或 source 页标注 raw_available: false。
• 新增、移动或重命名页面已进入正确 index。
• 当月日志已追加合法格式条目。
• 本次涉及页面的 Wikilink 均指向真实页面。
• 同名 raw/source 存在时，source 摘要使用路径限定 Wikilink，raw 只以文件路径或 canonical_raw 引用。
• 对外输出已检查分享边界。
• 交付说明列出修改文件、验证结果和遗留问题。

Anti-Patterns

• 未读权威协议就写文件。
• 在 skill 重复页面契约或域页面模板。
• 页面结构变化后漏改 index，或任何写操作后漏写日志。
• 使用占位、断开或有歧义的 Wikilink。
• 为一次性提及的名词创建空壳页面。
• 修改已有 raw，或只保留外部路径作为唯一证据。
• 忽略 ideas、todo 或分享边界。

会话末提示

若对话产生值得长期保留且尚未入库的内容，询问：

这次对话产生了一些值得入库的内容，要 Ingest 吗？

纯 debug/运维、内容已入库或用户已拒绝时不提示。