Communitygithub.com

liyading1818/obsidian-llm-wiki

Habilidades do agente Cursor para manter uma base de conhecimento pessoal no Obsidian com auxílio de LLM (wiki, vídeo2wiki)

O que é obsidian-llm-wiki?

Esta skill transforma o agente (Cursor, Claude Code, Codex) em um mantenedor disciplinado de uma base de conhecimento pessoal baseada em Obsidian, localizada em `<VAULT_ROOT>`. Ela permite que o agente realize consultas inteligentes com respostas sintetizadas e citações [[wikilink]], além de ingerir novos arquivos (como páginas web ou notas) e executar verificações de integridade (lint). Suporta a geração de artefatos como comparações, slides (Marp) e gráficos Python, salvando tudo no diretório `output/` com frontmatter padronizado. A skill segue estritamente as convenções definidas em `AGENTS.md`, garantindo que o agente nunca modifique arquivos brutos (`raw/` ou `clippings/`) e sempre atualize o índice (`wiki/index.md`) e o registro de alterações (`wiki/log.md`). É ideal para usuários que desejam manter um wiki curado com mínimo esforço manual, aproveitando a capacidade do LLM de sintetizar, analisar e organizar informações de forma consistente.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add liyading1818/obsidian-llm-wiki

Perguntar na sua IA favorita

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

Documentação

Habilidade de Wiki

Esta habilidade transforma o agente em um mantenedor disciplinado da base de conhecimento pessoal do usuário em <VAULT_ROOT> (a raiz do repositório).

Passo 0 — Sempre leia AGENTS.md primeiro

Antes de fazer qualquer coisa, leia AGENTS.md na raiz do vault. Ele define a estrutura de diretórios, convenções de página, esquema de frontmatter, formato de log e fluxos de trabalho detalhados. Este SKILL.md é apenas um despachante; AGENTS.md é a fonte da verdade.

Despacho: o que o usuário está pedindo?

Escolha exatamente uma dessas intenções a partir da mensagem do usuário:

Intenção do usuárioFluxo de trabalho
Fazendo uma pergunta, quer análise / sínteseConsulta (abaixo)
Enviou um novo arquivo ou disse "ingira isto"Ingestão (veja AGENTS.md §4.1)
Disse "lint" / "verificação de saúde" / "encontrar problemas"Lint (abaixo)
Quer uma comparação / apresentação de slides / gráfico / relatórioGerar artefato (abaixo)
Apenas explorando ou incertoExecute wiki stats e depois pergunte o que ele quer

Se não estiver claro, faça uma pergunta curta de esclarecimento antes de prosseguir.

Fluxo de trabalho de consulta

  1. Execute wiki search <palavra-chave> na raiz do repositório para encontrar páginas candidatas. Use múltiplas variações de palavra-chave, se necessário.

  2. Leia wiki/index.md para ver o catálogo.

  3. Leia as páginas candidatas encontradas no passo 1.

  4. Se ainda faltar contexto, recorra à leitura dos arquivos relevantes em raw/ ou clippings/.

  5. Sintetize uma resposta com citações [[wikilink]] para páginas do wiki e citações [artigo](../raw/xxx.md) para fontes brutas.

  6. Se a resposta tiver valor duradouro (uma comparação, um insight derivado, uma síntese não trivial), escreva-a como um arquivo markdown em output/<YYYY-MM-DD>-<slug-curto>.md com frontmatter:

    ---
    type: artifact
    kind: answer | comparison | analysis | report | slides
    created: <data>
    question: "<a pergunta do usuário, textual>"
    sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...]
    ---
    

    Em seguida, pergunte ao usuário: "要不要把这份输出归档为 wiki/questions/<slug>.md?" (Se sim, copie + atualize index.md e log.md.)

  7. Se a resposta for trivial (uma consulta de fato), apenas responda no chat — nenhum arquivo é necessário.

Fluxo de trabalho de lint

  1. Execute wiki lint — isso escreve lint/<hoje>.md automaticamente.
  2. Leia esse arquivo e resuma para o usuário (quais problemas são reais, quais são falsos positivos, como [[exemplos]] literais em documentação).
  3. Proponha um plano de correção priorizado. Não corrija automaticamente — deixe o usuário escolher.

Fluxo de trabalho de geração de artefato

Igual à consulta, mas a forma de entrega é explícita (tabela / slides Marp / gráfico Python / canvas). Sempre salve em output/. Para apresentações de slides, use o formato Marp markdown. Para gráficos, escreva um script Python em output/scripts/ e execute-o para produzir a imagem junto.

Convenção do diretório de saída

output/
├── 2026-06-26-rag-vs-llm-wiki.md          # artefato de resposta / comparação
├── 2026-06-26-karpathy-summary.slides.md  # apresentação de slides Marp
├── scripts/                                # scripts auxiliares para geração de gráficos
└── assets/                                 # imagens renderizadas, exportações

O diretório output/ é de propriedade do LLM, somente para anexação (não exclua artefatos anteriores sem perguntar). Cada arquivo deve ter o frontmatter mostrado acima para que o usuário possa posteriormente promover artefatos para o wiki.

Comandos CLI disponíveis (execute a partir de <VAULT_ROOT>)

Apenas quatro comandos, deliberadamente mínimos:

wiki stats              # visão geral: contagem de páginas por tipo/status
wiki log -n 10          # últimas N entradas de wiki/log.md
wiki search <regex>     # pesquisa de texto completo (--scope wiki|raw|clippings|all)
wiki lint               # escreve lint/<hoje>.md com órfãos/quebrados/stubs

Todo o resto (criar páginas, editar frontmatter, atualizar index.md, anexar a log.md) é feito lendo e escrevendo arquivos markdown diretamente. Não peça um CLI para fazer edições de arquivos — essa é sua função.

Regras críticas (de AGENTS.md)

  • Nunca modifique arquivos em raw/ ou clippings/.
  • Toda ingestão deve atualizar wiki/index.md e adicionar uma entrada no início de wiki/log.md no formato ## [YYYY-MM-DD] ingest | <título>.
  • Faça referência cruzada com [[colchetes-duplos]] entre páginas do wiki.
  • Páginas precisam de frontmatter YAML (type, tags, created, updated, sources, status).
  • Quando estiver em dúvida, pergunte ao usuário. Não faça grandes refatorações silenciosas.

Estilo de relatório

Após concluir um fluxo de trabalho, forneça ao usuário um breve resumo:

  • O que você fez (1–3 marcadores)
  • Quais artefatos foram criados ou modificados (caminhos relativos)
  • Quaisquer perguntas não resolvidas ou novas lacunas que você notou

Mantenha conciso. O usuário está navegando no Obsidian em paralelo e pode ver as alterações nos arquivos.

Habilidades Relacionadas