Obsidian Knowledge Pipeline#

概述#

本技能实现从URL到Obsidian知识库节点的全自动处理流水线。任意Agent加载本技能后，即可按照标准化7步流程将网络文章转化为结构化的知识库节点，包含配图、分类、双向链接和知识图谱关系。

环境变量#

变量默认值说明OBSIDIAN_VAULT_PATH``~/Documents/Obsidian VaultObsidian Vault 根目录DASHSCOPE_API_KEY_(无默认值)_Wan2.7 配图生成所需 API Key（可选，有则用Wan2.7脚本，无则用 image_generate 工具）

快速参考#

text

# 标准用法（Agent加载本skill后执行）
# 输入：一个或多个URL
# 输出：raw文章 + 配图 + 映射关系 + Wiki编译节点 + 知识图谱链接

# 关键路径
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
RAW_DIR="$VAULT/raw"
IMAGES_DIR="$RAW_DIR/images"
MAPPING_FILE="$IMAGES_DIR/关联关系.md"
WIKI_DIR="$VAULT/wiki/知识透视"
CLIPPINGS_DIR="$VAULT/Clippings"

7步流程总览#

text

URL → ① 抓取 → ② 存raw/ → ③ 生成配图 → ④ 更新映射 → ⑤ 自动分类 → ⑥ Wiki编译 → ⑦ 知识图谱

步骤说明详细文档① 抓取内容web_fetch 优先，scrapling 回退pipeline.md② 存入raw/标准模板存储原文pipeline.md③ 生成配图image_generate / Wan2.7image-mapping.md④ 更新映射关联关系.md 标准条目image-mapping.md⑤ 自动分类6大分类规则classification.md⑥ Wiki编译6要素结构化节点classification.md⑦ 知识图谱双向链接建立pipeline.md

详细文档索引#

• pipeline.md — 完整7步处理流程详细说明
• classification.md — 自动分类规则和Wiki编译标准
• image-mapping.md — 配图生成与映射规则

模板文件#

• templates/raw-article.md — Raw 文章存储模板
• templates/wiki-node.md — Wiki 节点编译模板
• templates/mapping-entry.md — 映射关系条目模板

禁止事项#

• ❌ 禁止使用 assets/ 目录存放配图，统一用 raw/images/
• ❌ 禁止硬编码 Vault 路径，必须通过 $OBSIDIAN_VAULT_PATH 环境变量
• ❌ 禁止硬编码 API Key，通过 $DASHSCOPE_API_KEY 环境变量引用
• ❌ 禁止跳过任何步骤，7步必须顺序执行
• ❌ 禁止在 Wiki 节点中省略6要素中的任何一个
• ❌ 禁止覆盖已有同名文件，遇到冲突时追加时间戳后缀
• ❌ 禁止在映射关系文件中使用非标准格式
• ❌ 禁止忽略 Clippings/ 目录的同步

Clippings/ 同步流程#

每次处理完文章后，需将编译结果同步到 Clippings/ 目录：

1. 在 $CLIPPINGS_DIR 下创建与 raw/ 同名的子目录结构
2. 将 Wiki 编译节点软链接或复制到对应位置
3. 确保 Clippings/ 中的 front matter 包含 source_url 字段

使用示例#

markdown

## Agent 调用流程

1. 读取本 SKILL.md，理解整体流程
2. 获取目标 URL
3. 按 pipeline.md 逐步执行
4. 使用 classification.md 进行分类和 Wiki 编译
5. 使用 image-mapping.md 处理配图
6. 各步骤使用 templates/ 中的标准模板