Wiki 知识伴侣
在 Obsidian 中搭建可持续累积的个人知识库。
证据显示技能声明不修改.raw源文件,并提供Git历史、可选远程备份和TLS风险警告;但允许Bash、Write、Edit等宽权限,脚手架会创建大量文件并初始化Git,未明确逐项确认、敏感数据处理或默认回滚,因此扣分。
目录结构、操作路由、模板和异常情形说明较完整,仓库还提供CI与测试证据;但本评估未执行,技能关键脚手架、路由和子技能链路缺少直接复现与明确失败反馈,按静态上限保守扣分。
触发词、目标用户、六类模式和跨项目场景较清楚;但非适用边界、中文输出行为及不同操作系统/中国大陆网络可达性说明不足,且部分流程依赖Obsidian、社区插件或外部服务,因此扣分。
SKILL.md采用分层结构并链接模式、CSS、Git、MCP等参考文档,提供命令、模板、许可证和安全政策;但选定技能缺少自身版本、变更记录、明确维护责任和完整故障排查,且社区推广页脚混入操作输出,故扣分。
目标是创建和维护持久Markdown知识库,结构、缓存、索引、日志和路由定义使核心价值明确;但代表性输出未在该技能文件中验证,许多结果依赖未评分子技能、外部工具和人工审阅,直接可用性证据有限。
存在提交修订、CI工作流、测试套件、架构说明和安全披露,支持部分审计;但这些证据主要覆盖仓库脚本而非该技能的完整用户路径,且本次未执行、无独立第三方复核,因此不超过静态上限。
- Bash与写文件权限较宽;首次脚手架、Git初始化、插件安装和远程备份前应逐项确认并先做可恢复备份。
- 知识库可能包含个人、健康、财务或机密资料;应明确原始数据、生成笔记、API密钥和远程推送的边界,避免将敏感内容发送到外部服务。
- MCP选项中的NODE_TLS_REJECT_UNAUTHORIZED=0只能限于本机回环连接;应优先验证Obsidian版本、插件、CLI和外部依赖在目标网络环境中的可达性。
- 该技能路由多个未提供内容的子技能;在采用前应分别审查其权限、输出、失败处理和数据流。
这个 Skill 能做什么,适合哪些场景?
这是一个面向 Claude Code 的 Obsidian 知识库编排技能。它会根据一句话描述搭建持久化 wiki vault,并通过索引、日志、热缓存和相互链接维护知识结构。它适合希望把 Markdown 文件作为长期知识资产、而不是只使用一次性聊天记录的用户。技能本身主要负责设置、脚手架、跨项目引用和热缓存管理,具体摄取、查询和检查工作会路由到其他技能。
读取 vault 状态和相关参考文件;根据用户对 vault 用途的描述选择模式并创建 wiki 文件夹结构、索引、日志、热缓存、概览、模板、CSS 片段和 vault 级 CLAUDE.md;提供从其他 Claude Code 项目读取同一 vault 的引用规则;在摄取、查询或其他重要操作后更新 hot.md,并将请求路由到 wiki-ingest、wiki-query、wiki-lint、save、autoresearch 或 canvas 等子技能;设置流程还会初始化 Git。
- 希望在 Obsidian 中建立个人第二大脑,并需要 Claude 持续维护目录、日志和近期上下文的个人用户。
- 需要为网站、代码库、业务、个人事务、研究或课程建立结构化知识库的用户。
- 同时管理多个 Claude Code 项目,并希望它们共享一个不重复复制上下文的 Markdown 知识库的用户。
- 刚开始使用 Obsidian、希望通过一句话描述用途后自动生成基础 vault 结构的用户。
这个 Skill 有哪些优点和局限?
- 以普通 Markdown 文件保存知识,结构和内容由用户拥有。
- 提供 index.md、log.md 和约 500 字的 hot.md,便于持续上下文和低成本检索。
- 支持跨项目引用同一 vault,避免在不同项目中重复维护知识。
- 脚手架流程明确,包含目录结构、模板、前置规范和 Git 初始化。
- 该技能依赖 Claude Code 的技能路由和斜杠命令语义,移植到其他客户端可能需要调整。
- SKILL.md 本身不包含 ingest、query 或 lint 的具体实现,它们依赖未提供正文的兄弟技能。
- 需要本地文件系统写入权限以及 Obsidian;Git 初始化步骤也要求可用 Git。
- source documents 位于 .raw/ 后不可修改,用户需要理解并遵守分层存储约定。
如何安装这个 Skill?
公开仓库的 README 提供了克隆并初始化的方式:git clone https://github.com/AgriciDaniel/claude-obsidian,然后进入目录运行 bash bin/setup-vault.sh,再将该目录作为 Obsidian vault 打开。之后在同一目录启动 Claude Code 并输入 /wiki。SKILL.md 没有单独说明仅安装 skills/wiki 的步骤。
如何使用这个 Skill?
在 Claude Code 中输入 /wiki、set up wiki、scaffold vault、create knowledge base 或 obsidian vault 等触发语句。首次设置时描述 vault 的用途;技能会询问“这个 vault 是做什么的?”并据此搭建结构。后续可使用 ingest [source]、what do you know about X? 或 lint the wiki,由编排器路由到相应子技能。
这个 Skill 与同类方案有什么区别?
与 RAG 不同,它把知识维护为持久化 wiki,并保留已有交叉引用、冲突标记和综合结果。与只回答现有笔记问题的聊天式 Obsidian AI 插件相比,它还负责搭建结构、归档知识和维护 vault。