mcpField
K
knowledge-base

knowledge-base

github.com/jacobrask生产力554 次安装44 周前更新
代码仓库

关于 knowledge-base

用于在 `~/knowledge/` 中维护主题化链接、笔记和软件资料集合的工作流与文件结构，指导用户整理、摘要和归档来自 Safari 等来源的内容。

主要功能

  1. 01组织主题、工具和归档
  2. 02按主题分配文章
  3. 03分批处理 Safari 标签页
  4. 04更新集合索引

适用场景

  1. 01将文章整理到主题文件
  2. 02按用途记录软件
  3. 03归档内容丰富或易失效的资料
  4. 04检查多批 Safari 标签页

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jacobrask/claude-skills --skill knowledge-base

安装后在 Claude Code 中输入/knowledge-base确认已加载。

详细介绍

知识库

位于 ~/knowledge/ 的主题分类精选链接和笔记集合。

结构

~/knowledge/
├── _index.md          # Topic listing
├── _inbox.md          # Unprocessed items
├── topics/*.md        # Articles, concepts, best practices
├── tools/*.md         # Software, libraries (organized by use case)
└── archive/YYYY-MM/   # Full article content (link rot protection)

条目格式

主题（文章／概念）：

**[Title](url)** — Author

1-2 paragraph summary focusing on core insights. Be extremely concise, disregard grammar.

工具（软件／库）：

### [tool-name](url)

**Platform:** macOS / JavaScript / Web Service
**Install:** Installation method
**Use case:** Problem it solves

Brief summary of why it's useful and when to use it.

**Alternatives:** other-tool (tradeoff)

工作流：从 Safari 添加

  1. 获取标签页：get_tabs.sh markdown 或 get_tabs.sh -w N markdown
  2. 分批处理，每批 8-10 个，避免上下文溢出
  3. 对每批内容：
    • 从 URL 获取内容
    • 阅读现有主题文件
    • 根据内容将条目归入相应主题
    • 将内容详实／独特的文章归档到 archive/YYYY-MM/
    • 不适合现有主题的条目 → _inbox.md
  4. 完成后更新 _index.md

路由

文章／概念 → topics/：

  • 根据内容匹配，而不只是看标题
  • 优先选择更具体的主题
  • 如果不确定，将条目添加到 _inbox.md 并注明建议的主题
  • 如果主题超过 500 行或 30 个条目，请用户拆分

软件／工具 → 按用途归入 tools/：

  • 库、命令行工具、应用和 Web 服务都归入此处
  • 关于工具的文章 → topics/
  • 根据需要创建新的用途分类文件

质量控制

批量添加时，如果遇到以下情况，请暂停并询问：

  • 内容不合适或质量较低
  • GitHub 仓库／gist（询问用户确认路由）
  • 获取失败（最后汇总并询问是否应只添加 URL）

归档

在以下情况下归档到 archive/YYYY-MM/：

  • 内容详实（超过 500 个单词）
  • 可能会消失（个人博客）
  • 有独特见解

跳过：GitHub 仓库、YouTube、频繁更新的文档、新闻

文件格式参考

主题文件：使用 YAML frontmatter，包含 tags、updated，然后是带条目的各个分节 工具文件：使用相同的 frontmatter，然后是包含元数据的 ### [tool](url) 条目

添加资源后，使用新主题／工具更新 _index.md。

查找资源

如果用户需要软件／库，在进行 Web 搜索前先检查 tools/。

评论

支持 Markdown