¿Qué hace Cobsidian?
Principio Fundamental
Mantén el vault como un sistema de conocimiento enlazado. No generes solo un archivo Markdown independiente.
Idioma de Respuesta
Usa el idioma del usuario para la selección de modo, preguntas de aclaración e informes de finalización.
- Solicitud en chino -> nombres de modo en chino.
- Solicitud en inglés -> nombres de modo en inglés.
- Solicitud en idioma mixto -> usa el idioma dominante del usuario e incluye los IDs de modo canónicos entre comillas invertidas cuando sea útil.
Resolución del Vault
Resuelve el vault destino en este orden:
- Ruta explícita del vault en la solicitud del usuario.
cobsidian.config.ymlconvault.path.- Configuración del host MCP a través de
COBSIDIAN_CONFIG. - Configuración del host MCP a través de
COBSIDIAN_VAULT.
No adivines una ruta de vault privada. Si no hay una ruta de vault válida disponible, pide una entrada concisa: la ruta del vault o la ruta del archivo de configuración. Si una ruta está presente pero no es válida, informa la ruta no válida y pide una ruta de vault/configuración corregida antes de escribir.
Selección de Modo
Si el usuario selecciona explícitamente un modo, úsalo y no muestres el menú completo de modos. Si no se selecciona ningún modo, infiere el modo más pequeño útil y menciónalo antes de escribir. Si el modo es ambiguo y hay ediciones de archivos involucradas, presenta brevemente los modos y haz una pregunta concisa antes de escribir.
| Modo | Disparadores en inglés | Disparadores en chino | Uso para |
|---|---|---|---|
learning | learning mode, study note, explain | 学习模式, 知识点整理, 学习笔记 | Conceptos, cursos, videos, artículos, explicaciones técnicas. |
project | project mode, repo analysis, architecture | 项目模式, 项目整理, 源码项目 | Arquitectura de proyecto, notas de implementación, análisis de repositorios, documentación operativa. |
review | review mode, retrospective, failure review | 复盘模式, 事故复盘, 实验复盘, 失败复盘 | Incidentes, resultados de experimentos, fallos, lecciones aprendidas. |
comparison | comparison mode, compare, evaluate options | 对比模式, 选型, 方案比较 | Elección de herramientas, opciones de arquitectura, comparaciones de modelos/bases de datos/frameworks. |
index | index mode, map, learning path | 索引模式, 总览, 知识地图, 学习路线 | Mapas de temas, notas centrales, rutas de aprendizaje, páginas de navegación. |
capture | capture mode, daily capture, quick note | 捕获模式, 日常记录, 先记下来 | Captura ligera diaria antes de una organización más profunda. |
dissection | dissection mode, teardown, source analysis | 拆解模式, 源码拆解, 框架拆解, skill拆解 | Ingeniería inversa de herramientas, repositorios, frameworks, sistemas de agentes, prompts, skills, flujos de trabajo. |
Introducción Interactiva de Modos
No asumas que el usuario ha leído el README o la documentación de los modos. Explica los modos en la conversación cuando:
- el usuario es nuevo en Cobsidian o pregunta qué puede hacer Cobsidian
- el usuario pide organizar/escribir material en Obsidian sin un tipo de nota claro
- el mismo material podría convertirse razonablemente en diferentes tipos de notas
- la edición objetivo diferiría según el modo, como una nota de aprendizaje pulida versus una captura diaria en bruto
Omite el selector cuando el usuario ya eligió un modo, el modo es obvio, o el usuario pidió ejecución directa. En ese caso, indica el modo inferido y continúa:
Mode: dissection / 拆解, porque esto es un desglose de un framework o flujo de trabajo.
Cuando se necesita el selector, usa el idioma del usuario.
Selector de modo en inglés:
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.
Selección de modo en chino:
Cobsidian 可以按这些模式整理:
- 学习模式:概念、课程、视频、论文、技术解释
- 项目模式:仓库、架构、实现、运维记录
- 复盘模式:失败、事故、实验结果、经验教训
- 对比模式:工具、模型、数据库、架构选型
- 索引模式:主题地图、学习路线、导航页
- 捕获模式:先快速保存粗糙材料,后续再整理
- 拆解模式:拆解工具、框架、仓库、skill、提示词系统
选一个模式,或者告诉我由我推断。
Flujo de Trabajo
- Identifica la ruta del vault del usuario y el tema objetivo.
- Busca notas existentes antes de escribir.
- Selecciona, infiere o presenta el modo antes de escribir.
- Decide una de:
- crear una nueva nota
- añadir a una nota existente
- dividir en múltiples notas
- solo reportar duplicados y preguntar antes de editar
- Escribe Markdown conciso con encabezados estables.
- Agrega
[[wiki links]]relevantes a notas existentes. - Agrega una sección
Notas relacionadascuando sea útil. - Ejecuta validación o al menos reporta lo que se verificó.
Reglas de Escritura
- Preserva el estilo de nombramiento de notas existente del usuario.
- Prefiere conceptos duraderos sobre resúmenes de transcripciones de chat.
- Mantén rutas privadas, tokens, nombres de cuenta y registros en bruto fuera de las notas genéricas a menos que el usuario solicite explícitamente registros operativos locales.
- No fabriques fuentes, nombres de archivo ni verificaciones completadas.
- Si el mismo tema ya existe, añade o fusiona en lugar de crear un casi duplicado.
Scripts Auxiliares
scripts/scan_vault.py: resume notas, títulos, etiquetas y enlaces wiki.scripts/find_duplicates.py: detecta títulos de notas duplicados o similares.scripts/suggest_backlinks.py: sugiere notas relacionadas para un borrador o nota objetivo.scripts/validate_notes.py: reporta enlaces wiki faltantes y problemas básicos de higiene.scripts/dry_run.py: planifica una escritura sin cambiar archivos; reporta decisión de crear/añadir, riesgos de duplicados, sugerencias de backlinks, intención de validación y escrituras vacías.
Usa --config cobsidian.config.yml cuando el usuario tenga una configuración de proyecto con vault.path, umbrales, límites de backlinks y preferencias de validación.
Lee references/note-types.md al elegir la forma de la nota.
Lee references/backlink-policy.md al agregar enlaces.
Lee references/markdown-style.md al formatear notas.
Informe de Finalización
Termina con:
- archivos creados o modificados
- decisión de crear/añadir
- verificaciones de duplicados realizadas
- sugerencias de backlinks añadidas u omitidas
- resultado de validación o razón por la que no se ejecutó la validación