首页 / 技能 / Claude Obsidian

📦 Claude Obsidian

v1.0.0

知识引擎Claude-Obsidian风格个人知识库构建与自动整理。当用户提到以下任何场景时激活：知识库、笔记整理、自动双向链接、Obsidian、第二大脑、卡片笔记、原子化笔记、个人知识管理、PKM、Zettelkasten、卢曼笔记法、笔记原子化、笔记链接、知识图谱笔记、raw/wiki/output三层、知...

0· 52·0 当前·0 累计
zmy1006-sudo 头像by @zmy1006-sudo (mingyuan)
AI模型访问文档工具笔记工具知识管理
下载技能包
最后更新
2026/4/21
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
medium confidence
该技能的代码、指令和请求的访问权限与一个本地 Obsidian 风格的知识库管理器一致：它在 Vault 中读写 markdown，扫描链接，提取标题/强调作为实体，并维护一个小型本地缓存——未声明任何凭据、下载或外部端点。
评估建议
该技能如其所述：会扫描并修改指定 Vault 中的 Markdown 文件，创建或更新笔记，生成修复脚本，并维护一个小的本地缓存。安装前请注意：1）备份 Vault——技能会写入文件，可能更新大量笔记。2）确认实体提取是否调用外部 AI：文档提到 API，但随附脚本为本地运行；请向作者确认是否需要网络请求或 API 密钥（以及密钥存储位置）。3）先在安全/测试 Vault 中运行脚本以查看输出（可用 --dry-run）。4）如有敏感内容，请在隔离环境中运行并监控网络流量，防止意外外发。整体而言，该包对其宣称功能内部一致，但请先核实外部 API 声明，再授予凭据或暴露私密数据。...
详细分析 ▾
✓ 用途与能力
名称/描述（Obsidian 风格知识库、自动链接、PKM）与所含脚本及 README 一致：自动链接、实体抽取、缓存管理、vault 文件更新。不索取无关凭据或二进制文件。
ℹ 指令范围
SKILL.md 指示 agent 读写 Vault（raw/、wiki/、output/）、运行内置 Python 脚本并创建/更新 frontmatter；这与声明目的相符。 一处不一致：references/scripts.md 称 extract_entities 使用“AI (via API)”抽取实体，但随附的 extract_entities.py 仅做本地正则抽取，无任何网络/API 调用。 另请注意，该 skill 会扫描 Vault 内全部 .md 文件（含敏感用户数据）；属预期行为，但需用户明确同意。
✓ 安装机制
无需安装说明或外部下载；该技能仅包含指令和本地脚本。脚本已打包在内，通过 python3 本地运行。这是风险最低的安装方式。
ℹ 凭证需求
未声明或依赖任何环境变量、密钥或外部凭证。然而，文档提到使用 AI “API”（却未声明任何 API 密钥或环境变量），存在不一致——若真调用外部 API，理应需要凭证。就交付的代码而言，它不会泄露密钥，也不会索取无关凭证。
✓ 持久化与权限
技能并非强制启用；它不会请求提升的平台权限。它会写入用户 Vault（创建 .cache/hot_cache.json 和 .claude_fix_suggestions.sh，如所述），这适合作为知识库管理器。
安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/21

初始版本：AI自动整理个人知识库，raw/wiki/output三层架构，双向链接自动织网

● 无害

安装命令

点击复制
官方npx clawhub@latest install claude-obsidian-kb
镜像加速npx clawhub@latest install claude-obsidian-kb --registry https://cn.longxiaskill.com

技能文档

灵感来源：AgriciDaniel/claude-obsidian + Andrej Karpathy LLM Wiki 模式
核心理念：你只管写，AI负责整理、链接和维护——知识随时间复利增长

---

核心原则

传统 AI 插件 = 问答机器人（Session级，无持久记忆） Claude-Obsidian 知识引擎 = AI员工（持久化 Vault，知识自动织网） 每次对话都是对知识库的写操作。AI 不只是回答问题，而是主动更新、维护、链接笔记。

---

三层架构

`` raw/ 原始素材层：文章/论文/网页剪藏/会议记录，只增不改 wiki/ 结构化知识层：AI编译后的 concepts · entities · topics output/ 产出层：基于 wiki 生成的报告/分析/回答 `

---

必选文件（Vault 根目录）

1. CLAUDE.md — AI 员工手册

Vault 根目录创建 CLAUDE.md，AI 启动时自动读取。结构： `markdown # AI 助手角色定义

身份

你是一个专业的知识管理员，负责维护[用户]的个人知识库。

关注领域

  • [列出专业领域]

目录结构规范

  • raw/ — 原始素材，只增不改
  • wiki/ — 结构化知识
- wiki/concepts/ — 概念页 - wiki/entities/ — 实体页（人/组织/产品） - wiki/topics/ — 主题页
  • output/ — 产出物

frontmatter 模板

每个 wiki 页面必须包含： title: 标题 type: concept | entity | topic tags: [领域, 子领域] sources: [来源链接或空数组] created: YYYY-MM-DD updated: YYYY-MM-DD summary: 一句话描述（≤50字）

链接规则

  • 首次提到概念 → [[笔记名]] 双向链接
  • 同一笔记内同一概念只链接第一次
  • 提到不存在实体 → 询问是否创建

行为准则

  • 整理用户输入时，主动提取实体和概念
  • 发现矛盾信息 → 添加 [!contradiction] 标记
  • 定期检查孤儿笔记和死链
`

2. SCHEMA.md — 规范定义（≤50行）

`markdown # 知识库规范

命名规范

  • 概念页：全小写，英文优先，用 - 连接。如 neural-network
  • 实体页：人名英文全名（姓在前）。如 turing-alan

标签体系

顶级标签（预设，禁止自创）： [领域列表]

frontmatter 必填字段

  • title, type, tags, sources, created, updated, summary

目录结构

  • 超过10篇笔记 → 建立子目录
  • index.md 放在每个主要目录（3-5行导航）
`

---

核心工作流

工作流 A：输入素材 → wiki 化 

用户输入素材（URL/文本/文件）  
↓  
[提取实体和概念]  
↓  
检查 vault 中是否存在对应笔记  
有 → 更新现有笔记 + 添加链接  
无 → 创建新笔记 + 链接  
↓  
写入 raw/（原始素材）+ wiki/（结构化页面）  
更新相关笔记的双向链接

工作流 B：双向链接自动织网 

扫描日记/笔记中的所有提及（人名/地名/书名/概念）  
↓  
对每个提及在 vault 中搜索  
存在 → 替换为 [[笔记名]] 双向链接  
不存在 → 创建对应实体页 → 链接  
↓  
生成孤儿笔记报告

工作流 C：知识整理（批量） 

用户: "整理我所有的 [项目/领域] 笔记"  
↓  
扫描相关目录  
↓  
统一添加 frontmatter  
建立双向链接  
生成/更新 index.md

---

卡片笔记原子化标准

每张笔记只包含一个原子思想：

| 类型 | 内容 | 长度 | |---------|--------------------------|----------| | concept | 一个概念的定义+解释+例子 | 100-300字 | | entity | 一个实体的关键事实 | 100-500字 | | topic | 一个主题的现状+关键问题 | 300-800字 |

---

矛盾检测

发现两篇笔记对同一事实描述矛盾时：
  • 在矛盾处添加 [!contradiction] Obsidian callout
  • 记录矛盾双方
  • 在相关笔记的 summary 中标注"存在争议"
  • 提示用户核实

---

定期维护任务

| 任务 | 频率 | 操作 | |------------------|--------------|-------------------------------------------| | 死链检测 | 每次对话末尾 | 检查 [[链接]] 是否存在 | | 孤儿笔记报告 | 按需 | 无任何笔记链接的笔记 | | 批量添加frontmatter | 按需 | 对缺少字段的笔记统一补全 | | index.md 更新 | 按需 | 新增笔记后更新目录索引 |

---

脚本工具

运行方式：python3 /workspace/skills/claude-obsidian-kb/scripts/
数据来源：ClawHub ↗ · 中文优化：龙虾技能库