Communitygithub.com

Totoro-qaq/Cobsidian

与代理无关的工作流技能,用于维护 Obsidian 知识库

Cobsidian 是什么?

Cobsidian 是一个与 AI 代理无关的工作流技能,旨在帮助用户高效维护 Obsidian 知识库,将其组织成一个互联的知识系统,而非生成孤立的 Markdown 文件。它支持多种整理模式,包括学习、项目、复盘、对比、索引、捕获和拆解,能够根据用户需求自动推断或手动选择最合适的模式,以生成结构化的笔记。该技能可在 Claude Code、Cursor、Codex 等支持 MCP(模型上下文协议)的代理平台上运行,通过配置文件或环境变量(如 `COBSIDIAN_VAULT`)定位 Obsidian 仓库路径。Cobsidian 强调在写入前搜索现有笔记、避免重复、添加相关 wiki 链接,并提供了多个辅助脚本(如扫描、查重、验证)来优化笔记创建和管理流程。其核心优势在于代理无关性、多模式灵活性、以及对现有知识库结构的深度整合,确保笔记之间相互关联,形成真正的知识网络。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Totoro-qaq/Cobsidian

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Cobsidian 是做什么的?

核心原则

将知识库维护为一个关联的知识系统。不要仅仅生成一个独立的 Markdown 文件。

回复语言

根据用户的语言进行模式选择、澄清问题和完成报告。

  • 中文请求 -> 中文模式名称。
  • 英文请求 -> 英文模式名称。
  • 混合语言请求 -> 使用用户的主要语言,并在有用时在反引号中包含规范的模式 ID。

仓库定位

按以下顺序定位目标仓库:

  1. 用户请求中明确的仓库路径。
  2. cobsidian.config.yml 中的 vault.path。
  3. MCP 主机配置中的 COBSIDIAN_CONFIG。
  4. MCP 主机配置中的 COBSIDIAN_VAULT。

不要猜测私有仓库路径。如果没有可用的有效仓库路径,请要求用户提供一个简洁的输入:仓库路径或配置路径。如果路径存在但无效,请报告无效路径并要求用户在写入前提供正确的仓库/配置路径。

模式选择

如果用户明确选择了模式,则使用该模式,不要显示完整的模式菜单。如果未选择模式,则推断出最有用的小模式,并在写入前说明。如果模式不明确且涉及文件编辑,请简要介绍模式,并在写入前提出一个简洁的问题。

模式英文触发词中文触发词用途
learninglearning mode, study note, explain学习模式, 知识点整理, 学习笔记概念、课程、视频、论文、技术解释。
projectproject mode, repo analysis, architecture项目模式, 项目整理, 源码项目项目架构、实现笔记、仓库分析、运维文档。
reviewreview mode, retrospective, failure review复盘模式, 事故复盘, 实验复盘, 失败复盘事件、实验结果、失败、经验教训。
comparisoncomparison mode, compare, evaluate options对比模式, 选型, 方案比较工具选择、架构选项、模型/数据库/框架比较。
indexindex mode, map, learning path索引模式, 总览, 知识地图, 学习路线主题地图、中心笔记、学习路线、导航页。
capturecapture mode, daily capture, quick note捕获模式, 日常记录, 先记下来轻量级日常捕获,后续再进行深度整理。
dissectiondissection mode, teardown, source analysis拆解模式, 源码拆解, 框架拆解, skill拆解逆向工程工具、仓库、框架、代理系统、提示词、技能、工作流。

交互式模式介绍

不要假设用户已阅读 README 或模式文档。在以下对话场景中解释模式:

  • 用户是 Cobsidian 新手,或询问 Cobsidian 能做什么
  • 用户泛泛地要求将材料组织/写入 Obsidian,但没有明确的笔记类型
  • 同一份材料合理上可以生成不同类型的笔记
  • 目标编辑会根据模式不同而变化,例如润色后的学习笔记与粗略的日常捕获

当用户已经选择了模式、模式很明显、或用户要求直接执行时,跳过模式选择界面。在这种情况下,说明推断出的模式并继续:

模式: dissection / 拆解,因为这是对框架或工作流的拆解。

当需要模式选择界面时,使用用户的母语。

英文模式选择界面:

Cobsidian can organize this in several modes:
- learning: concepts, courses, videos, papers
- project: repos, architecture, implementation, operations
- review: failures, incidents, experiments, lessons
- comparison: tool/model/database/architecture choices
- index: topic maps, learning paths, hub notes
- capture: quick rough notes for later cleanup
- dissection: internals of tools, frameworks, repos, skills, prompts

Choose one mode, or tell me to infer it.

中文模式选择:

Cobsidian 可以按这些模式整理:
- 学习模式:概念、课程、视频、论文、技术解释
- 项目模式:仓库、架构、实现、运维记录
- 复盘模式:失败、事故、实验结果、经验教训
- 对比模式:工具、模型、数据库、架构选型
- 索引模式:主题地图、学习路线、导航页
- 捕获模式:先快速保存粗糙材料,后续再整理
- 拆解模式:拆解工具、框架、仓库、skill、提示词系统

选一个模式,或者告诉我由我推断。

工作流

  1. 确定用户的仓库路径和目标主题。
  2. 在写入前搜索现有笔记。
  3. 在写入前选择、推断或介绍模式。
  4. 决定以下操作之一:
    • 创建新笔记
    • 追加到现有笔记
    • 拆分为多个笔记
    • 仅报告重复项并在编辑前询问
  5. 使用稳定的标题编写简洁的 Markdown。
  6. 添加到现有笔记的相关 [[wiki 链接]]。
  7. 在有用时添加 相关笔记 部分。
  8. 运行验证或至少报告已检查的内容。

写入规则

  • 保留用户现有的笔记命名风格。
  • 优先使用持久的概念,而非聊天记录摘要。
  • 除非用户明确要求本地操作记录,否则不要将私有路径、令牌、账户名和原始日志放入通用笔记中。
  • 不要捏造来源、文件名或已完成的检查。
  • 如果同一主题已存在,请追加或合并,而不是创建近乎重复的笔记。

辅助脚本

  • scripts/scan_vault.py: 汇总笔记、标题、标签和 wiki 链接。
  • scripts/find_duplicates.py: 检测重复或相似的笔记标题。
  • scripts/suggest_backlinks.py: 为草稿或目标笔记建议相关笔记。
  • scripts/validate_notes.py: 报告缺失的 wiki 链接和基本卫生问题。
  • scripts/dry_run.py: 计划写入而不更改文件;报告创建/追加决策、重复风险、反向链接建议、验证意图和空写入。

当用户具有包含 vault.path、阈值、反向链接限制和验证偏好的项目配置时,使用 --config cobsidian.config.yml。

在选择笔记形状时阅读 references/note-types.md。 在添加链接时阅读 references/backlink-policy.md。 在格式化笔记时阅读 references/markdown-style.md。

完成报告

以如下内容结束:

  • 创建或修改的文件
  • 创建/追加决策
  • 执行的重复检查
  • 已添加或跳过的反向链接建议
  • 验证结果或未运行验证的原因

相关技能