Cobsidian 是做什么的?
核心原则
将知识库维护为一个关联的知识系统。不要仅仅生成一个独立的 Markdown 文件。
回复语言
根据用户的语言进行模式选择、澄清问题和完成报告。
- 中文请求 -> 中文模式名称。
- 英文请求 -> 英文模式名称。
- 混合语言请求 -> 使用用户的主要语言,并在有用时在反引号中包含规范的模式 ID。
仓库定位
按以下顺序定位目标仓库:
- 用户请求中明确的仓库路径。
cobsidian.config.yml中的vault.path。- MCP 主机配置中的
COBSIDIAN_CONFIG。 - MCP 主机配置中的
COBSIDIAN_VAULT。
不要猜测私有仓库路径。如果没有可用的有效仓库路径,请要求用户提供一个简洁的输入:仓库路径或配置路径。如果路径存在但无效,请报告无效路径并要求用户在写入前提供正确的仓库/配置路径。
模式选择
如果用户明确选择了模式,则使用该模式,不要显示完整的模式菜单。如果未选择模式,则推断出最有用的小模式,并在写入前说明。如果模式不明确且涉及文件编辑,请简要介绍模式,并在写入前提出一个简洁的问题。
| 模式 | 英文触发词 | 中文触发词 | 用途 |
|---|---|---|---|
learning | learning mode, study note, explain | 学习模式, 知识点整理, 学习笔记 | 概念、课程、视频、论文、技术解释。 |
project | project mode, repo analysis, architecture | 项目模式, 项目整理, 源码项目 | 项目架构、实现笔记、仓库分析、运维文档。 |
review | review mode, retrospective, failure review | 复盘模式, 事故复盘, 实验复盘, 失败复盘 | 事件、实验结果、失败、经验教训。 |
comparison | comparison mode, compare, evaluate options | 对比模式, 选型, 方案比较 | 工具选择、架构选项、模型/数据库/框架比较。 |
index | index mode, map, learning path | 索引模式, 总览, 知识地图, 学习路线 | 主题地图、中心笔记、学习路线、导航页。 |
capture | capture mode, daily capture, quick note | 捕获模式, 日常记录, 先记下来 | 轻量级日常捕获,后续再进行深度整理。 |
dissection | dissection 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、提示词系统
选一个模式,或者告诉我由我推断。
工作流
- 确定用户的仓库路径和目标主题。
- 在写入前搜索现有笔记。
- 在写入前选择、推断或介绍模式。
- 决定以下操作之一:
- 创建新笔记
- 追加到现有笔记
- 拆分为多个笔记
- 仅报告重复项并在编辑前询问
- 使用稳定的标题编写简洁的 Markdown。
- 添加到现有笔记的相关
[[wiki 链接]]。 - 在有用时添加
相关笔记部分。 - 运行验证或至少报告已检查的内容。
写入规则
- 保留用户现有的笔记命名风格。
- 优先使用持久的概念,而非聊天记录摘要。
- 除非用户明确要求本地操作记录,否则不要将私有路径、令牌、账户名和原始日志放入通用笔记中。
- 不要捏造来源、文件名或已完成的检查。
- 如果同一主题已存在,请追加或合并,而不是创建近乎重复的笔记。
辅助脚本
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。
完成报告
以如下内容结束:
- 创建或修改的文件
- 创建/追加决策
- 执行的重复检查
- 已添加或跳过的反向链接建议
- 验证结果或未运行验证的原因