用途
wiki 是 claude-obsidian 技能体系中的编排（orchestration）入口，用于初始化、接管并路由针对一个独立 Obsidian 知识库（vault）的工作。其核心原则是把已安装的产品当作代码、把用户选定的 vault 当作数据，二者严格分离：即使当前目录恰好是产品检出目录，也绝不能把插件/产品根目录当作 vault 使用。
主要能力
-
解析可移植核心：从本技能的安装位置解析出可移植核心，并以绝对路径调用：
CORE=/absolute/product/root/scripts/claude-obsidian.py python3 "$CORE" --help -
解析 vault：按以下顺序确定目标 vault：显式
--vault、环境变量CLAUDE_OBSIDIAN_VAULT、最近的.claude-obsidian.json，然后是当前目录或其上级中唯一且已初始化的 vault。当选择缺失或存在歧义时，采取失败关闭（fail closed）策略。 -
基线设置无需网络出口：除非用户另行批准目标与预算，否则不抓取模板、插件或远程内容。
-
设置 vault：使用确定性设置命令，二者默认均为 dry-run。
新建独立 vault：
python3 "$CORE" init /absolute/path/to/vault \ --generated-at <ISO-UTC> --operation-id init-reviewed python3 "$CORE" init /absolute/path/to/vault \ --generated-at <ISO-UTC> --operation-id init-reviewed \ --approved-plan-sha256 <reviewed-sha256> --apply接管已有 Obsidian vault：
python3 "$CORE" adopt /absolute/path/to/vault \ --generated-at <ISO-UTC> --operation-id adopt-reviewed python3 "$CORE" adopt /absolute/path/to/vault \ --generated-at <ISO-UTC> --operation-id adopt-reviewed \ --approved-plan-sha256 <reviewed-sha256> --apply在
--apply之前，需展示所选路径与变更路径预览，然后原样传入输出的approved_plan_sha256。除非用户已审阅冲突并明确批准替换，否则不要使用--force。设置默认非破坏性，且不会创建上游 Git remote。 -
领域专属脚手架：若用户要求领域专属脚手架，先建立基线，再阅读
modes.md，把附加页面与配置作为单个操作级事务起草。绝不要用宿主 Write/Edit 工具或 Obsidian 传输来改动 vault 文件。
使用方式：路由操作
按用户意图路由，且不得静默扩大范围：
| 意图 | 技能 |
|---|---|
| 摄取提供的来源 | wiki-ingest |
| 基于已有 vault 知识作答 | wiki-query |
| 保存特定对话结果 | save |
| 在预算内研究公开网络 | autoresearch |
| 检查 vault 健康状况 | wiki-lint |
| 汇总日志条目 | wiki-fold |
| 处理 canvas | canvas |
查询为只读。查询产生的持久化必须是一次显式、单独限定范围的 Save 操作。绝不因为会话结束就捕获转录或更新热缓存。
变更契约
在任何自定义脚手架或变更之前，先阅读 operation-transactions.md。一个逻辑操作必须产出一个经过检查且可恢复的 claude-obsidian.transaction.v1 事务包。并行代理只能返回草稿与证据；由编排器合并并一次性应用。每个规范页面的创建或删除，都必须在该事务包中包含一次活跃索引或 MOC 更新；仅当稳定的高层图景发生变化时才更新概览。原始来源载荷为只创建（create-only）。不存在自动提交。
在初始化或更改来源与主张账本时，使用 provenance.md。不受支持的证据保持不受支持；绝不编造来源、引文、日期、定位符或置信度。
成功应用后，报告操作 ID 与确切的变更路径。若用户明确需要 Git 检查点，单独运行：
python3 "$CORE" checkpoint OPERATION_ID --vault /absolute/path/to/vault
发生冲突时，重新读取并重建。发生中断时，使用事务恢复（transaction recover）。仅当事务包完全相同时才可复用操作 ID。
安装上下文与条件引用
当安装或宿主行为重要时，阅读 install-modes.md。钩子（Hooks）是可选适配器；可移植行为存在于核心与技能中。
仅阅读当前请求所需的引用：
frontmatter.md：定义或接管属性模式时；css-snippets.md：需要 Obsidian 视觉定制时；git-setup.md：显式设置本地 Git 或检查点时；plugins.md：评估可选 Obsidian 集成时；mcp-setup.md：用户要求评估外部读取传输时；rest-api.md：仅当用户明确拥有或请求 Local REST API 适配器时。
适用场景与限制
适用于需要以可移植、可审计、非破坏性的方式初始化或接管 Obsidian vault，并按意图把工作路由到相应子技能的场景。限制包括：基线设置默认不联网；设置命令默认 dry-run，需审阅并批准后才应用；查询只读，持久化需单独授权；不得用宿主编辑工具直接改动 vault；不得编造来源或证据；无自动提交。关于收费、价格、平台支持范围等事实，资料中暂未提供。