| 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
- 读取
<WIKI_ROOT>/purpose.md、CLAUDE.md 和 index.md。
- Query：读取
references/wiki-query.md、相关知识域 index.md，再读取最相关页面。
- Ingest / Update：读取
sources/CLAUDE.md（涉及来源时）、相关知识域 CLAUDE.md 和 index.md。
- Lint：根据被检查页面的路径读取对应域
CLAUDE.md，再按当前 vault 的实际结构执行检查。
- 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/运维、内容已入库或用户已拒绝时不提示。
