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ário | Fluxo de trabalho |
|---|---|
| Fazendo uma pergunta, quer análise / síntese | Consulta (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ório | Gerar artefato (abaixo) |
| Apenas explorando ou incerto | Execute 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
-
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. -
Leia
wiki/index.mdpara ver o catálogo. -
Leia as páginas candidatas encontradas no passo 1.
-
Se ainda faltar contexto, recorra à leitura dos arquivos relevantes em
raw/ouclippings/. -
Sintetize uma resposta com citações
[[wikilink]]para páginas do wiki e citações[artigo](../raw/xxx.md)para fontes brutas. -
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>.mdcom 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.) -
Se a resposta for trivial (uma consulta de fato), apenas responda no chat — nenhum arquivo é necessário.
Fluxo de trabalho de lint
- Execute
wiki lint— isso escrevelint/<hoje>.mdautomaticamente. - 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). - 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/ouclippings/. - Toda ingestão deve atualizar
wiki/index.mde adicionar uma entrada no início dewiki/log.mdno 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.