Obsidian KB Skill
可安装让知识可检索,让沉淀有边界
把检索和沉淀装进你的 Agent
两个 Skill 共用一个 Vault:只读检索返回路径和行号,写入只在你明确授权后进行。
请从官方仓库 https://github.com/Spc-jgs/obsidian-kb-skill 安装最新稳定版 Obsidian Knowledge Base Skill。
先阅读 README、安装器帮助和 CHANGELOG,再使用官方安装器。识别当前平台和我的 Obsidian Vault;无法可靠判断时先询问我,不要猜路径。保留我的 Vault 内容、自定义模板和其他平台配置,不要强制覆盖。
安装完成后,请从非仓库目录分别运行写入与检索 Skill 的 doctor --json,再执行一次只读检索 smoke test。向我报告版本、Vault 路径、安装平台、安装位置和验证结果;检查失败时停止,不要删除或重建 Vault。SKILLS
两个 Skill,一个 Vault
obsidian-knowledge-retrieval只读检索。从 Vault 里找答案,返回路径和行号,不修改笔记。
obsidian-knowledge-base受控沉淀。只有你明确要求保存时,才创建或更新笔记。
TRY SAYING
可以这样对它说
- 检索
在我的 Obsidian 里找一下,我们之前如何处理多 Agent 交接?
- 沉淀
把这次架构评审的结论沉淀到知识库。
- 复盘
复盘这次对话,找出值得长期保存的问题、知识、反思和设计;低价值内容不要写。
- 剪藏
剪藏这篇文章,保留原理、实践步骤、验证方式和来源证据。
关于这件作品
聊天里的结论、学习记录与排障经验,需要在下一次工作中找得到。这个项目让 AI Agent 在已有 Obsidian Vault 中寻找上下文,并按知识库规则沉淀新的理解。
只读检索返回文件路径、行号和片段;知识写入则经过治理规则、模板与 Git 状态预检。确定性的步骤交给本地 helper,普通问答不会自动获得写权限。
IN PRACTICE
可以用它做什么
- 只读检索:本地词法排序与双语概念扩展,回答可追溯到文件和行号。
- 受控沉淀:支持多类笔记、网页证据归档、模板、索引与写后审计。
- 多平台共用:支持 Codex、QoderWork、WorkBuddy、Claude Code 和 Cursor,共用一个 Vault。
开始之前
- 需要 Python 3.11 或更高版本,以及一个 Obsidian Vault。只复制一个指令文件不能完成安装。
- 检索不写入 Vault。创建和更新只在明确授权、并通过预检之后进行。
- 使用云端 Agent 时,读到的笔记片段仍可能发送给模型提供商。本站不公开个人 Vault。