Communitygithub.com

Totoro-qaq/Cobsidian

Skill de fluxo de trabalho agnóstico a agentes para manter bases de conhecimento Obsidian

O que é Cobsidian?

Cobsidian é um skill de fluxo de trabalho projetado para manter bases de conhecimento Obsidian de forma consistente e interligada. Ele é agnóstico a agentes, funcionando com ferramentas como Claude Code, Cursor e Codex. O principal objetivo é garantir que as notas não sejam apenas arquivos Markdown isolados, mas partes de um sistema de conhecimento vinculado, utilizando links wiki e referências cruzadas. O skill oferece modos especializados (como aprendizagem, projeto, revisão, comparação, captura e dissecção) que orientam o agente sobre como organizar e escrever o conteúdo. Ele também inclui scripts auxiliares para escanear o vault, detectar duplicatas, sugerir backlinks e validar a estrutura das notas. Cobsidian prioriza a preservação do estilo de nomenclatura existente do usuário e evita a criação de duplicatas, fundindo ou anexando conteúdo quando apropriado. Seu processo de resolução de vault segue uma ordem clara: caminho explícito, arquivo de configuração, variáveis de ambiente do MCP host. Em caso de ambiguidade, o skill interage com o usuário para selecionar o modo mais adequado antes de escrever qualquer nota.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Totoro-qaq/Cobsidian

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Cobsidian faz?

Princípio Central

Mantenha o vault como um sistema de conhecimento vinculado. Não gere apenas um arquivo Markdown isolado.

Idioma da Resposta

Combine com o idioma do usuário para seleção de modo, perguntas de esclarecimento e relatórios de conclusão.

  • Solicitação em chinês -> nomes de modo em chinês.
  • Solicitação em inglês -> nomes de modo em inglês.
  • Solicitação em idioma misto -> use o idioma dominante do usuário e inclua IDs de modo canônicos entre crases quando útil.

Resolução do Vault

Resolva o vault alvo nesta ordem:

  1. Caminho explícito do vault na solicitação do usuário.
  2. cobsidian.config.yml com vault.path.
  3. Configuração do host MCP através de COBSIDIAN_CONFIG.
  4. Configuração do host MCP através de COBSIDIAN_VAULT.

Não adivinhe um caminho de vault privado. Se nenhum caminho de vault válido estiver disponível, peça uma entrada concisa: o caminho do vault ou o caminho da configuração. Se um caminho estiver presente mas for inválido, reporte o caminho inválido e peça um caminho de vault/config corrigido antes de escrever.

Seleção de Modo

Se o usuário selecionar explicitamente um modo, use-o e não mostre o menu completo de modos. Se nenhum modo for selecionado, infira o menor modo útil e informe-o antes de escrever. Se o modo for ambíguo e houver edições de arquivo envolvidas, apresente os modos brevemente e faça uma pergunta concisa antes de escrever.

ModoGatilhos em inglêsGatilhos em chinêsUso para
learninglearning mode, study note, explain学习模式, 知识点整理, 学习笔记Conceitos, cursos, vídeos, artigos, explicações técnicas.
projectproject mode, repo analysis, architecture项目模式, 项目整理, 源码项目Arquitetura de projetos, notas de implementação, análise de repositórios, docs operacionais.
reviewreview mode, retrospective, failure review复盘模式, 事故复盘, 实验复盘, 失败复盘Incidentes, resultados de experimentos, falhas, lições aprendidas.
comparisoncomparison mode, compare, evaluate options对比模式, 选型, 方案比较Escolhas de ferramentas, opções de arquitetura, comparações de modelo/banco de dados/framework.
indexindex mode, map, learning path索引模式, 总览, 知识地图, 学习路线Mapas de tópicos, notas hub, caminhos de aprendizado, páginas de navegação.
capturecapture mode, daily capture, quick note捕获模式, 日常记录, 先记下来Captura diária leve antes de uma organização mais profunda.
dissectiondissection mode, teardown, source analysis拆解模式, 源码拆解, 框架拆解, skill拆解Engenharia reversa de ferramentas, repositórios, frameworks, sistemas de agentes, prompts, skills, fluxos de trabalho.

Introdução Interativa ao Modo

Não presuma que o usuário leu o README ou a documentação dos modos. Explique os modos na conversa quando:

  • o usuário é novo no Cobsidian ou pergunta o que o Cobsidian pode fazer
  • o usuário pede genericamente para organizar/escrever material no Obsidian sem um tipo claro de nota
  • o mesmo material poderia razoavelmente se tornar diferentes tipos de nota
  • a edição alvo diferiria por modo, como uma nota de aprendizado polida vs uma captura diária bruta

Pule o seletor quando o usuário já escolheu um modo, o modo é óbvio ou o usuário pediu execução direta. Nesse caso, informe o modo inferido e continue:

Modo: dissection / 拆解, porque isso é uma desmontagem de framework ou fluxo de trabalho.

Quando o seletor for necessário, use o idioma do usuário.

Seletor de modo em 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.

Seletor de modo em chinês:

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

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

Fluxo de Trabalho

  1. Identifique o caminho do vault do usuário e o tópico alvo.
  2. Pesquise notas existentes antes de escrever.
  3. Selecione, infira ou apresente o modo antes de escrever.
  4. Decida uma das opções:
    • criar uma nova nota
    • anexar a uma nota existente
    • dividir em várias notas
    • apenas relatar duplicatas e perguntar antes de editar
  5. Escreva Markdown conciso com cabeçalhos estáveis.
  6. Adicione [[wiki links]] relevantes para notas existentes.
  7. Adicione uma seção Notas relacionadas quando for útil.
  8. Execute validação ou pelo menos reporte o que foi verificado.

Regras de Escrita

  • Preserve o estilo de nomenclatura de notas existente do usuário.
  • Prefira conceitos duráveis em vez de resumos de transcrição de chat.
  • Mantenha caminhos privados, tokens, nomes de conta e logs brutos fora de notas genéricas, a menos que o usuário explicitamente queira registros operacionais locais.
  • Não invente fontes, nomes de arquivo ou verificações concluídas.
  • Se o mesmo tópico já existir, anexe ou mescle em vez de criar uma nota quase duplicada.

Scripts Auxiliares

  • scripts/scan_vault.py: resume notas, títulos, tags e links wiki.
  • scripts/find_duplicates.py: detecta títulos de notas duplicados ou semelhantes.
  • scripts/suggest_backlinks.py: sugere notas relacionadas para um rascunho ou nota alvo.
  • scripts/validate_notes.py: relata links wiki ausentes e problemas básicos de higiene.
  • scripts/dry_run.py: planeja uma escrita sem alterar arquivos; relata a decisão de criar/anexar, riscos de duplicação, sugestões de backlinks, intenção de validação e escritas vazias.

Use --config cobsidian.config.yml quando o usuário tiver uma configuração de projeto com vault.path, limiares, limites de backlinks e preferências de validação.

Leia references/note-types.md ao escolher a forma da nota. Leia references/backlink-policy.md ao adicionar links. Leia references/markdown-style.md ao formatar notas.

Relatório de Conclusão

Termine com:

  • arquivos criados ou modificados
  • decisão de criar/anexar
  • verificações de duplicatas realizadas
  • sugestões de backlinks adicionadas ou ignoradas
  • resultado da validação ou motivo pelo qual a validação não foi executada

Habilidades Relacionadas