mcpField
O
obsidian-project-kb-core

obsidian-project-kb-core

github.com/galaxy-dawn生产力5.9k324 次安装1 周前更新
代码仓库

关于 obsidian-project-kb-core

这是一个规定如何在 Obsidian 中维护项目级知识的工作流技能，可用于整理项目笔记、管理笔记生命周期、更新索引与注册表，并运行确定性健康检查。

主要功能

  1. 01将代码仓库绑定到项目根目录
  2. 02创建并维护项目结构
  3. 03将笔记分流至项目文件夹
  4. 04管理笔记生命周期与链接
  5. 05运行脚本进行一致性和 Lint 检查

适用场景

  1. 01搭建项目知识工作区
  2. 02将研究笔记归入项目分类
  3. 03检查注册表、索引和链接的一致性

安装

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

$npx skills add https://github.com/galaxy-dawn/claude-scholar --skill obsidian-project-kb-core

安装后在 Claude Code 中输入/obsidian-project-kb-core确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
BINDING-LAYER.md
DAILY-PROMOTION.md
DIRECTORY-SCHEMA.md
HUB-PLAN-INDEX.md
LIFECYCLE.md
LINT.md
REGISTRY.md
scripts/
kb_canvas_check.py
kb_common.py
kb_index_check.py
kb_link_check.py
kb_lint.py
kb_registry_check.py
kb_scaffold.py
project_kb.py

详细介绍

Obsidian 项目知识库核心

这是项目范围内 Obsidian 知识维护的主要工作流规范。

默认项目根目录：

Research/{project-slug}/

默认结构：

00-Hub.md
01-Plan.md
02-Index.md
Sources/
Knowledge/
Experiments/
Results/
  Reports/
Writing/
Daily/
Maps/
Archive/
_system/

核心规则

  • 将所有持久项目知识保存在当前的 Research/{project-slug}/ 中。
  • 仅将仓库本地的 .claude/project-memory/* 用作运行时绑定层。
  • _system/registry.md 是唯一可见的项目注册表。
  • 02-Index.md 是供人查阅的导航笔记，而非注册表镜像。
  • Maps/ 是派生内容区域；默认不要生成非必要的画布。
  • Results/Reports/ 是轮次和批次实验报告的默认子目录。

职责

  • 检测当前仓库并将其绑定到项目根目录
  • 初始化项目骨架
  • 将笔记归入 Sources / Knowledge / Experiments / Results / Results/Reports / Writing / Daily / Maps / Archive
  • 更新 00-Hub.md、01-Plan.md、02-Index.md
  • 更新 _system/registry.md、_system/schema.md、_system/lint-report.md
  • 处理笔记生命周期操作：创建、更新、重命名、归档、清除、提升和链接修复
  • 通过辅助脚本运行确定性健康检查

确定性辅助工具

使用 scripts/ 下的脚本进行：

  • 搭建骨架
  • 检查注册表一致性
  • 检查链接
  • 检查索引
  • 检查画布
  • 汇总 lint 结果

使用 Agent 进行：

  • 笔记归类
  • 日记提升决策
  • 判断内容属于来源还是知识
  • 判断结果是否稳定
  • 语义化更新 Hub 和 Index

后续阅读

  • references/DIRECTORY-SCHEMA.md
  • references/HUB-PLAN-INDEX.md
  • references/REGISTRY.md
  • references/DAILY-PROMOTION.md
  • references/LIFECYCLE.md
  • references/LINT.md
  • references/BINDING-LAYER.md

评论

支持 Markdown