Compound Vault 方法论模式
为 Obsidian 知识库按 LYT、PARA、Zettelkasten 或 Generic 规则路由新页面。
技能仅声明 Read、Write、Bash,核心操作围绕读取或写入 .vault-meta/mode.json;设置脚本采用交互式选择,切换模式明确不自动迁移,降低误删和数据破坏风险。扣分原因是 Bash 权限较宽,未在本技能中明确展示输入校验、写入前确认、异常回滚、敏感数据处理或完整数据流说明。
模式、目录约定、配置 schema、消费者集成和迁移行为描述较一致;仓库 CI 还验证了 wiki-mode CLI 的 get/config/id/templates 接口。扣分原因是本次仅静态阅读,未执行关键路径,且 setup-mode.sh、wiki-mode.py 及三个消费者的实现未提供,异常输入、配置损坏和失败反馈覆盖不足。
四种模式、适用场景、默认 generic 行为、切换和迁移边界均有说明,且核心功能为本地 Markdown 与 JSON,不依赖完全不可达的海外服务。扣分原因是未明确语义触发的排除条件、中文使用示例或语言行为,也未充分说明小型 vault、混合模式和自定义路由的非适用边界。
技能有清晰的四模式结构、schema、路由表、模板、迁移说明和交叉引用;README、MIT license、Security policy、版本叙述和 CI 提供了仓库级维护信号。扣分原因是选定技能本身没有独立版本、changelog、维护责任人或更新路径说明,且关键外部文档和消费者契约未包含在本次技能证据中。
对于设置或解释 vault 方法论模式,技能给出了可直接采用的目录规则、配置格式和模板,并明确既有文件不会自动迁移。扣分原因是实际路由结果依赖其他未提供的技能和脚本,模板只是建议,未有代表性输出或端到端执行证据,用户仍可能需要人工处理迁移和 MOC/链接维护。
仓库包含真实 CI 工作流,并明确调用 wiki-mode CLI 表面;同时存在覆盖其他脚本的提交测试套件。扣分原因是没有本技能专属测试源码、第三方复核或独立复现结果;静态审查无法确认实现与文档完全一致,因此按静态上限给分。
- 在生产 vault 中切换模式前,应备份并人工检查 .vault-meta/mode.json;切换不会迁移现有文件,且新旧目录可能长期并存。
- 应审查 setup-mode.sh、wiki-mode.py 及三个消费者的实际实现,确认模式值校验、路径清理、写入失败处理和权限边界。
- 该技能未提供中文触发词或中文输出示例;中文用户应验证自然语言调用是否稳定命中。
这个 Skill 能做什么,适合哪些场景?
wiki-mode 是 claude-obsidian 仓库中的独立 Agent Skill,用于为 Compound Vault 选择和读取组织方法。它支持 LYT、PARA、Zettelkasten 和 Generic 四种模式,并将配置写入 `.vault-meta/mode.json`。其他相关技能会读取该配置,以决定来源、实体、概念、会话和研究页面的存放位置。默认模式是 Generic,可保持 v1.6/v1.7 的原有行为。
读取 .vault-meta/mode.json,在配置不存在时使用 generic;通过 bash bin/setup-mode.sh 交互式设置或切换模式;根据内容类型和当前模式返回安全的文件路径规则;为 LYT、PARA 和 Zettelkasten 提供对应模板和文件夹约定;让 wiki-ingest、save 和 autoresearch 等技能在新页面归档时遵循该模式。
- 希望用 MOC 和扁平原子笔记组织超过 100 页知识库的 Obsidian 用户,可选择 LYT。
- 管理多个项目和长期责任、希望按行动性归档资料的知识工作者,可选择 PARA。
- 研究人员、学者或长期思考者,需要带唯一 ID 和密集双向链接的原子笔记时,可选择 Zettelkasten。
- 从 v1.7 迁移或不想采用固定方法的用户,可继续使用 Generic。
这个 Skill 有哪些优点和局限?
- 提供 LYT、PARA、Zettelkasten 和 Generic 四种明确的组织方案。
- 通过 `.vault-meta/mode.json` 统一配置,并由三个归档相关技能读取。
- Generic 默认模式保持原有目录结构,降低迁移门槛。
- 提供模式专属模板和清晰的文件命名、目录及 frontmatter 约定。
- 它主要负责模式配置和路由,实际页面创建依赖 `wiki-ingest`、`save` 或 `autoresearch` 等其他技能。
- 切换模式不会自动迁移已有文件,迁移需要手动完成。
- 设置模式依赖 Bash 脚本和本地文件系统;SKILL.md 没有记录独立于该仓库的安装流程。
- Zettelkasten 模式要求较高,包括唯一时间戳 ID、原子笔记和父子 ID 管理。
如何安装这个 Skill?
该技能随 AgriciDaniel/claude-obsidian 的 15 个技能集合提供。可将仓库克隆为 Obsidian vault:git clone https://github.com/AgriciDaniel/claude-obsidian,进入目录后运行 bash bin/setup-vault.sh。wiki-mode 本身不需要额外的 bin/setup-*.sh;只有设置非默认模式时才需要运行 bash bin/setup-mode.sh。
如何使用这个 Skill?
在 vault 根目录运行 bash bin/setup-mode.sh,选择 LYT、PARA、Zettelkasten 或 Generic。也可以使用“set vault mode”“switch to PARA”“use LYT”“what's my vault mode”或“zettelkasten setup”等触发语句。切换后,新页面按新模式归档;已有文件不会自动迁移。
这个 Skill 与同类方案有什么区别?
README 将该模式系统与 Ideaverse Pro 2.0 的 LYT 结构作对比,并称 claude-obsidian 还提供 PARA、Zettelkasten 和模式感知路由。与 Smart Connections 和 Copilot 的对比表则显示,这些产品未列出同等的内建方法论模式支持;具体选择仍取决于是否需要 Claude Code 驱动的本地 Markdown vault 路由。