alfredzhang98/research-obsidian-skill

ai-wiki — arquivar conteúdo na base de conhecimento (leve, padrão)

Transforma "escreve isto" numa nota com nome e links corretos, dentro da pasta gerenciada por IA.

Este comando não cria tópicos. Produz uma única nota e requer pelo menos um [[wikilink]] para uma nota existente. Para colocar uma nota sob um hub temático com links recíprocos, use /ai-wiki-full.

Por que os tópicos estão desativados por padrão: quando cada artigo ganha seu próprio hub, o hub não organiza nada — apenas dá ao artigo um nome mais longo. Um tópico é uma direção de pesquisa, não o assunto de um artigo. O teste está em references/note-specs.md sob "O que se qualifica como tópico".

Para onde vai a saída

Tudo que este skill arquiva vai para a pasta gerenciada por IA.

Zona	Como tratar
Pasta gerenciada por IA (<AI_WIKI>/**)	criar / editar / mover / renomear / apagar — mão livre
Pastas de notas próprias do usuário	ler e pesquisar livremente; edições aditivas são ok; pergunte antes de apagar, renomear, mover ou sobrescrever
.claude/rules/, CLAUDE.md	configuração estática — edite apenas quando o usuário pedir para alterar o comportamento do Claude; atualize updated:. A única exceção dinâmica é .claude/rules/active.md
.obsidian/, .trash/	acessível mas mãos-livres — editar a configuração do Obsidian pode quebrar o vault

Nada está bloqueado na camada de permissão, então a restrição acima é de julgamento. Um vault geralmente não é um repositório git; uma sobrescrita ruim de uma nota escrita à mão é recuperável apenas pelo histórico de versões da sincronização de arquivos.

Ler dessas zonas e arquivar um resumo na pasta gerenciada por IA é exatamente para isso que este skill serve.

Arquivos de referência — leia o que precisa, não todos os quatro

Arquivo	Leia quando
references/vault-guide.md	decidir qual pasta — tabela de roteamento, exemplos de frases do usuário, modelo de tags/wikilinks
references/note-specs.md	escrever uma nota de artigo, nota de aprendizado ou plano de tópico — nomes de arquivo, frontmatter, especificações de seção, regras de redação
references/figures-diagrams.md	a nota precisa de figuras — comando de extração, formato de incorporação, regras do mermaid
references/tools.md	escolher qual skill ou CLI manipula a entrada, além dos fluxos de trabalho completos

Arquivamento rotineiro (uma pasta óbvia, sem figuras) não precisa de nenhum deles — o procedimento abaixo é suficiente.

Procedimento

1. Classifique — escolha exatamente uma pasta de destino da tabela de roteamento em references/vault-guide.md. Um conteúdo, uma pasta; qualquer coisa transversal depende de tags: e [[wikilinks]], nunca de uma cópia duplicada.
   • Registros não consolidados, exploratórios ou em lote vão para Inbox/, não para uma pasta real.
   • Realmente ambíguo entre duas pastas: pergunte, não adivinhe e duplique.
2. Nomeie — conforme references/note-specs.md (minúsculas com kebab-case):
   • artigo → Research/papers/<sobrenome-primeiro-autor>-<ano>-<slug-2-3-palavras>.md (este comando não cria tópico, então a nota vai na raiz de papers/; /ai-wiki-full coloca em papers/<slug-do-tópico>/)
   • aprendizado → Research/learning/<slug-do-tópico>-<YYYYMMDD>.md
3. Verifique primeiro se existe uma nota — faça Glob na pasta de destino antes de escrever (para artigos use Research/papers/**/*.md; observe as subpastas por tópico). Atualizar a nota certa é melhor que criar uma quase duplicada; se já existir uma, mescle nela e informe.
4. Preencha — Leia o esqueleto correspondente em Templates/ (paper-note.md / learning-note.md) e preencha-o no local; nunca reconstrua a estrutura de memória. As orientações de seção estão em references/note-specs.md, não nos prompts {{...}} do esqueleto.
   • Os blocos > [!callout] são o sistema de ênfase — mantenha-os, não adicione novos tipos.
   • O cartão rápido no topo é escrito por último: ele comprime a nota finalizada. Se suas seis linhas não puderem ser preenchidas, a nota abaixo não está pronta.
   • S0 "O que este artigo faz, em linguagem simples" é obrigatório: 3-5 frases para alguém que conhece o básico da área mas não leu este artigo. Ordem: a situação que enfrentam, o que construíram, por que funciona, o que obtiveram. Se você não consegue escrever esta seção, não entendeu o artigo — pare e releia em vez de continuar.
   • Uma nota de artigo responde, em ordem: S0 linguagem simples → S1 contexto → S2 o que o trabalho anterior não conseguia fazer → S3-S4 método e matemática → S5 o que foi executado → S6 o que resultou → S7 limitações e trabalho futuro dos autores → S8 minha análise e oportunidades de pesquisa.
   • S2 e S8 são a razão de existir da nota — nenhuma pode ser preenchida com prosa genérica. A matemática de S4 deve ser reconstruível a partir da nota, não apenas reconhecível.
   • Cada oportunidade de S8 carrega todas as quatro linhas (oportunidade → por que ainda não resolvida → primeiro experimento → em qual tópico arquivar). "Nenhuma oportunidade que valha a pena — <porquê>" é válido; uma inventada não é.
   • Redação profissional: sem rótulos metafóricos ("o corte deste artigo", "o veredito", "o número mais forte"). Veja a tabela de redação em references/note-specs.md. Cada julgamento deve recair sobre evidências específicas.
   • Leia o artigo antes de escrever. Nunca preencha uma seção a partir do resumo; se o texto do PDF para uma seção não estiver disponível, escreva {{não disponível na fonte}} em vez de preenchimento plausível.
5. Figuras — conforme references/figures-diagrams.md: figuras de artigo via skill paper-figures para _attachments/paper-figures/<slug-do-artigo>/ (a árvore de anexos permanece plana, nunca espelhada em pastas de tópicos), incorporadas na seção onde cada figura faz o trabalho.
   • O prefixo de incorporação depende da profundidade da nota: ../../_attachments/... na raiz de papers/, ../../../_attachments/... dentro de papers/<slug-do-tópico>/. Esta é a única coisa que falha silenciosamente quando uma nota é movida — verifique uma imagem.
   • Diagramas criados usam um bloco mermaid. Arte ASCII é proibida.
6. Vincule (obrigatório, pelo menos um) — a nota deve carregar pelo menos um [[wikilink]] para uma nota existente: um hub em Research/topics/, outra nota de artigo, ou uma nota de aprendizado.
   • Faça Glob em Research/topics/ e Research/papers/ primeiro, escolha o alvo mais próximo e indique o relacionamento em uma frase, em vez de soltar um link nu.
   • Este comando não cria tópicos. Se não houver nada para vincular, sinalize em .claude/rules/active.md que isso abre uma nova área e informe ao usuário que /ai-wiki-full é o comando que constrói um hub.
   • Quando a nota se encaixa em um tópico existente, adicione o link direto na lista S6 desse tópico — links recíprocos são o que faz o grafo clusterizar.
7. Registre — se isso abre uma nova direção ou é trabalho em andamento, adicione um ponteiro de uma linha para .claude/rules/active.md e atualize seu updated:. Não espelhe estado lá. active.md é o único arquivo de regras que este fluxo de trabalho toca sem uma solicitação explícita de alteração de configuração.

Autoverificação antes de finalizar

• Cada caminho escrito está dentro da pasta gerenciada por IA
• O nome do arquivo corresponde à especificação para seu tipo de nota; uma nota de artigo está na raiz de papers/ (este comando não cria tópico)
• O prefixo de incorporação corresponde à profundidade da nota, e pelo menos uma imagem foi verificada
• Frontmatter completo (tags: presente e específica, não apenas research/)
• Pelo menos um [[wikilink]] para uma nota existente, com o relacionamento indicado
• Construído a partir do arquivo de modelo real, ordem das seções e callouts intactos
• Resumo em linguagem simples S0 preenchido, sem jargão técnico
• Cartão rápido escrito por último; todas as seis linhas são afirmações concretas e ele é auto-suficiente
• Nenhum {{placeholder}} deixado na nota entregue
• Nenhum rótulo metafórico
• Figuras incorporadas inline, não jogadas no final
• Nota de artigo: S2 nomeia métodos anteriores reais e sua falha específica; S7 separa declarado pelos autores / meu / trabalho futuro deles; S8 cita evidências na conclusão e cada oportunidade tem todas as quatro linhas
• Nota de aprendizado: S1 é a pergunta do usuário literalmente; S5 tem um exemplo numérico real
• Informou ao usuário o(s) caminho(s) exato(s) escrito(s)

Relacionados

Para criar ou encontrar um hub temático com links recíprocos, use /ai-wiki-full. Escolha da ferramenta por tipo de entrada: references/tools.md. Regras de zona completas: .claude/rules/permissions.md.