SHAOPC / SPACE
← 全部作品
PROJECT / 工作流

Obsidian KB Skill

可安装

让知识可检索,让沉淀有边界

ObsidianAI AgentPython

把检索和沉淀装进你的 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 交接?

  • 沉淀

    把这次架构评审的结论沉淀到知识库。

  • 复盘

    复盘这次对话,找出值得长期保存的问题、知识、反思和设计;低价值内容不要写。

  • 剪藏

    剪藏这篇文章,保留原理、实践步骤、验证方式和来源证据。

THE IDEA

关于这件作品

聊天里的结论、学习记录与排障经验,需要在下一次工作中找得到。这个项目让 AI Agent 在已有 Obsidian Vault 中寻找上下文,并按知识库规则沉淀新的理解。

只读检索返回文件路径、行号和片段;知识写入则经过治理规则、模板与 Git 状态预检。确定性的步骤交给本地 helper,普通问答不会自动获得写权限。

IN PRACTICE

可以用它做什么

  • 只读检索:本地词法排序与双语概念扩展,回答可追溯到文件和行号。
  • 受控沉淀:支持多类笔记、网页证据归档、模板、索引与写后审计。
  • 多平台共用:支持 Codex、QoderWork、WorkBuddy、Claude Code 和 Cursor,共用一个 Vault。
BEFORE YOU START

开始之前

  • 需要 Python 3.11 或更高版本,以及一个 Obsidian Vault。只复制一个指令文件不能完成安装。
  • 检索不写入 Vault。创建和更新只在明确授权、并通过预检之后进行。
  • 使用云端 Agent 时,读到的笔记片段仍可能发送给模型提供商。本站不公开个人 Vault。
PROJECT JOURNEY

一路走来

  1. PROJECT JOURNEY

    Obsidian KB Skill 加入公开作品索引

    整理已有公开介绍与源码入口。这是本次收录记录,项目更早的版本与开发历程将在核实后补充。