agentleFS
81895626sun-rgb81895626sun-rgb/claude-obsidian-wiki/skills/wiki-add/SKILL.md

wiki-add

Skill0 starsChanged 7 months agoMITView on GitHub

将新文档处理并提炼到 Obsidian 风格 wiki 知识库中。当用户说"加入知识库"、"整理这篇笔记"、"添加到 wiki"、"/wiki-add",或者提供了一篇文章/笔记需要归入知识库时,使用此 skill。适用于带主索引、知识地图和 wiki 页面目录的结构化知识库。

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. taeeho/ClaudeSkills★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

Files
SKILL.md

Wiki Add

将原始文档提炼成 wiki 知识库中的一篇规范页面。

目标

不是复制原文,而是提炼:把原始素材转化为你自己的理解——核心心智模型、关键速查表、决策依据。读者(未来的你)应该能在 30 秒内获得关键信息。

默认配置约定

本插件是一个偏 Obsidian、偏中文知识库的默认实现。公开版不再绑定某个私有路径,但仍假设你维护一套结构化 vault。

默认约定如下:

  • VAULT_ROOT:你的知识库根目录
  • INDEX_FILE:_Index.md
  • KNOWLEDGE_MAP_FILE:知识地图.md
  • WIKI_DIR:wiki/
  • SOURCE_ARCHIVE_DIR:原始文件/
  • LOG_FILE:log.md
  • INDEX_LINK_NAME:_Index
  • KNOWLEDGE_MAP_LINK_NAME:知识地图
  • 页面章节默认使用:一句话定义 / 核心内容 / 使用场景 / 注意事项 / 关联笔记
  • frontmatter 默认字段:title / tags / category / created / source
  • 页面引用默认使用 Obsidian wikilink:[[页面名]]

如果你的 vault 文件名、目录名、章节标题或日志格式不同,请先按需修改本 skill 中的默认约定。

执行流程

第零步:判断输入类型

用户提供的参数可能是:

  • 单个文件路径 → 直接进入第一步
  • 文件夹路径 → 执行批量模式(见下方"批量模式")
  • URL → 直接进入第一步
  • 粘贴文本 → 直接进入第一步

批量模式(输入为文件夹路径时)

B1:列出文件夹内所有待处理文件

用 Glob 或 Bash 列出文件夹内所有 .md 文件(递归),排除已在 <VAULT_ROOT>/<INDEX_FILE> 中收录的文件。

同时读取 <VAULT_ROOT>/<INDEX_FILE>,记录所有已收录的 [[页面名称]],用于后续跳过判断。

B2:逐篇处理

对列表中每个文件,按顺序执行完整的单篇流程(第一步至第八步),每篇完成后:

  • 输出一行进度:[X/N] 已完成:<wiki页面名> → <分类>
  • 立即更新 <INDEX_FILE>(不要等全部完成再批量写)

跳过条件:文件内容为空,或文件名/内容明显是"日志"、"草稿"、"TODO"类个人备忘且无提炼价值 → 输出 [X/N] 跳过:<文件名>(原因),继续下一个。

B3:批量完成后汇总

输出一个简洁汇总表:

批量处理完成
新增 wiki 页面:N 篇
新增分类:X 个(列出名称)
跳过文件:Y 个

B4:自动健康检查

批量模式结束后,自动执行一次 wiki-lint 的完整检查流程,输出健康检查报告。如有可自动修复的问题,询问用户后修复。


单篇模式(输入为单文件 / URL / 粘贴文本)

第一步:读取现有结构

读取 <VAULT_ROOT>/<INDEX_FILE>,了解现有分类体系,记住所有顶层分类及其 emoji。

同时用 Glob 检查 <VAULT_ROOT>/<WIKI_DIR> 目录下已有的文件名列表,用于后续去重。

第二步:理解原始文档

用户会提供以下之一:

  • 文件路径 → 按下方策略读取
  • URL → 用 WebFetch 抓取;若返回 403 或需登录(知乎、飞书云文档、微信公众号等均属此类),告知用户"该页面无法直接抓取,请粘贴正文内容"后等待用户粘贴再继续
  • 粘贴的文本内容 → 直接分析

文件读取策略:

先尝试直接读取全文。若文件过大报错,改用以下流程:

  1. 用 Grep 提取所有标题,获取完整大纲
  2. 根据标题判断最有价值的章节(通常是:开头定义段、核心概念章节、总结段)
  3. 用 offset + limit 定向读取这些章节,跳过冗余内容

标题不清晰时(如"步骤一"、"说明"、"方案"),三步降级:

  1. 读每个章节的首段(3-5 行)→ 判断主题
  2. 若还不够 → Grep 关键技术词(命令名、工具名、API 名),代码块往往直接暴露主题
  3. 综合以上信息自行归纳主题,不依赖标题

理解文档后,思考:

  • 这篇文章的核心是什么?(一句话)
  • 读者最需要记住的 2-5 个关键点是什么?
  • 是否有值得保留的速查表、对比表、决策树?

第三步:确定分类与去重

对照 <INDEX_FILE> 中的现有分类:

  • 能归入已有分类 → 直接使用
  • 属于全新领域 → 在 <INDEX_FILE> 新增一个顶层分类,配合合适的 emoji

去重检查:如果 <WIKI_DIR> 下已存在同名或主题高度重合的页面,告知用户并询问是"跳过"还是"覆盖更新"。

第四步:生成 wiki 页面

文件路径:<VAULT_ROOT>/<WIKI_DIR>/<页面名称>.md

页面名称规则:用主题关键词,中文或英文,无空格(如 Scrapling、PowerShell-Get-Content、Docker基础命令)。

使用以下模板:

---
title: ""
tags: []
category: ""
created: YYYY-MM-DD
source: ""
---

## 一句话定义

## 核心内容

## 使用场景

## 注意事项

## 关联笔记

- [[_Index]]
- [[知识地图]]

关联笔记写法:

  • 始终包含 [[<INDEX_LINK_NAME>]] 和 [[<KNOWLEDGE_MAP_LINK_NAME>]]
  • 如果用户提供的是文件路径,同时加上原文链接:[[原文件名不含扩展名|原文]](使用 Obsidian 最短路径匹配,不写完整路径)
  • 如果用户提供的是 URL,在 frontmatter 的 source 字段填入该 URL,关联笔记中不加原文链接
  • 如有相关 wiki 页面也一并链接

各部分写法:

  • 一句话定义:这是什么,解决什么问题,30 字以内
  • 核心内容:根据内容类型灵活选择形式:
    • 工具/框架 → 核心心智模型 + 选型表
    • 命令/API → 参数速查表 + 高频用法代码块
    • 概念/方法论 → 关键原则 + 使用条件
    • 教程/配置 → 核心思路 + 关键步骤要点(不是完整步骤,是决策点)
  • 使用场景:什么情况下用这个
  • 注意事项:只写非显而易见的坑,没有就省略这一节
  • 关联笔记:至少包含 [[_Index]] 和 [[知识地图]],如有相关 wiki 页面也要链接

第五步:归档原始文件(仅当用户提供文件路径时执行)

如果用户提供的是文件路径(而非粘贴文本),将原文件复制到:

<VAULT_ROOT>/<SOURCE_ARCHIVE_DIR>/<分类名>/<原文件名>

分类名规则:取分类标题中的文字部分,去掉 emoji,将 / 替换为 -。 例:🎯 营销 / 用户运营 → 营销-用户运营

如果目标目录不存在,先创建再复制。复制方式可用 Bash 或其他本地文件操作,关键是:

  • 不改原文件内容
  • 归档副本落到 <SOURCE_ARCHIVE_DIR>/<分类名>/

第六步:更新主索引

在 <VAULT_ROOT>/<INDEX_FILE> 对应分类下追加一行:

- [[页面名称]] — 一句话说明这篇页面讲什么

同时更新文件末尾的 *最后更新:YYYY-MM-DD*。

如果新建了分类,在对应位置插入新的 ## emoji 分类名 标题和条目。

第七步:更新知识地图

在 <VAULT_ROOT>/<KNOWLEDGE_MAP_FILE> 对应分类的表格中追加一行:

| [[页面名称]] | 一句话说明 |

规则:

  • 找到与分类对应的表格(按 emoji + 分类名匹配)
  • 在该表格末尾追加新行,保持表格格式一致
  • 如果是新分类,在文件末尾(--- 分隔线和最后一行 *最后更新* 之前)插入完整的新分类块:
## emoji 分类名

**核心主题**:(根据文章内容用一句话概括该领域主题)

| 文章 | 一句话 |
|------|--------|
| [[页面名称]] | 一句话说明 |

---

同时更新文件中 > 本库共 **N 篇** 的数量(N + 1)。

第八步:记录日志

在 <VAULT_ROOT>/<LOG_FILE> 追加一条记录(文件不存在则创建):

## [YYYY-MM-DD] ingest | 页面名称
- 来源:文件路径 / URL / 粘贴文本
- 分类:emoji 分类名
- 新建分类:是/否

完成后告知用户

用中文简洁说明:

  1. 创建的页面名称(带路径)
  2. 归入哪个分类
  3. 是否新建了分类
  4. 原始文件是否已归档(若有)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.