Este capítulo inicia a quinta parte: Colaboração com IA.
As quatro partes anteriores cobriram o próprio Obsidian — como começar, configurar, escrever e publicar. Esta parte aborda o outro lado: com ferramentas de IA como Claude Code e Codex, que podem ler e escrever diretamente em arquivos locais, seu cofre Obsidian não é mais apenas um caderno para você ler; ele também se torna uma bancada onde a IA pode trabalhar diretamente.
Este capítulo primeiro explica como começar, com três métodos em ordem crescente de dificuldade e automação:
- O método mais simples: dar diretamente o caminho do arquivo para a IA, deixar que ela leia e processe o arquivo original
- Obsidian CLI: mais eficiente do que ler arquivos diretamente, adequado quando seu cofre tem muitos arquivos
- Skill: solidificar todo o fluxo de trabalho em um único comando, totalmente automatizado
Dar Diretamente o Caminho do Arquivo para a IA
Este é o método mais simples — sem necessidade de plugins, sem conhecimento de CLI.
A IA aqui se refere a ferramentas como Claude Code ou Codex que podem ler e escrever diretamente em arquivos locais, não a interfaces de chat baseadas na web como DeepSeek ou ChatGPT.
Você só precisa dar ao Claude Code ou Codex o caminho completo para um arquivo, e ele pode ler o arquivo e processá-lo diretamente no original. Por exemplo:
- “Resuma os pontos principais desta nota:
/Users/yourusername/Documents/Obsidian/01Notes/some-note.md” - “Traduza este artigo para o inglês e sobrescreva o original”
- “Verifique este rascunho em busca de erros de digitação e problemas de lógica, e corrija-os”
A IA lê o conteúdo do arquivo, entende sua solicitação e escreve o conteúdo modificado de volta. Resumo, tradução, polimento, ajustes de formatação — essas tarefas pontuais são bem adequadas para este método.
A barreira é extremamente baixa; você pode usar imediatamente. A única desvantagem é que você precisa especificar manualmente a solicitação e o caminho toda vez, tornando-o adequado para uso ocasional.
Obsidian CLI
Dar caminhos de arquivo diretamente funciona, mas quando seu cofre tem muitos arquivos, a IA escanear arquivos cegamente fica lenta e os resultados podem não ser precisos. É aí que entra a CLI.
Após atualizar para a versão mais recente do Obsidian, uma interface CLI está disponível, permitindo que a IA opere diretamente em seu cofre por meio de comandos.
Alguns podem perguntar: a IA já não consegue ler meus arquivos diretamente? Por que precisamos da CLI?
Aqui vai uma analogia. Seu cofre Obsidian é uma biblioteca com centenas de livros.
Sem CLI: Quando a IA precisa encontrar informações, ela só pode procurar entre as estantes, folheando livros um por um, ou depender de você dizer “vá para a terceira fileira, segundo livro.”
Com CLI: A biblioteca ganha um sistema de recuperação. A IA insere um tópico, e o sistema diz diretamente quais arquivos são relevantes, onde estão, quais palavras-chave estão nas notas — e também pode criar novos arquivos, atualizar propriedades e mover conteúdo entre pastas.
A diferença de eficiência é enorme. Quando seu cofre tem muitos arquivos, a precisão e a velocidade com que a IA encontra coisas são de níveis completamente diferentes com ou sem CLI.
Como Usar
A maneira mais simples: diga diretamente à IA para usar a CLI durante sua conversa.
Por exemplo, se você quer que a IA organize suas notas, basta dizer: “Use o Obsidian CLI para pesquisar conteúdo sobre XXX na minha pasta 01Notes/”, e a IA chamará o comando obsidian search para recuperar, em vez de escanear arquivos cegamente. Comandos comuns incluem:
- Pesquisar conteúdo:
obsidian search vault="OBSIDIAN_VAULT" query="palavra-chave" path="01Notes" - Ler arquivo:
obsidian read vault="OBSIDIAN_VAULT" path="04Output/nome-do-arquivo.md" - Criar nota:
obsidian create vault="OBSIDIAN_VAULT" path="caminho-destino.md" content="..." - Listar pasta:
obsidian files vault="OBSIDIAN_VAULT" folder="04Output"
Você não precisa memorizar esses comandos; basta dizer à IA o que deseja fazer e deixá-la escolher qual comando usar.
Uma maneira ainda mais conveniente é solidificar essas operações em uma Skill. Na Skill, pré-defina quais operações devem ser feitas via CLI, e a IA seguirá automaticamente as regras da Skill, sem que você precise lembrá-la toda vez. Minha Skill de escrita para o WeChat Official Account funciona assim — ela especifica pesquisar materiais com obsidian search, gerar artigos com obsidian create e definir propriedades com obsidian property:set. Toda vez que a IA executa essa Skill, ela usa automaticamente a CLI para operar o cofre, sem instruções adicionais.
Skill: Transforme um Fluxo de Trabalho em um Único Comando
A CLI resolve o problema de “encontrar”, mas você ainda precisa declarar suas necessidades manualmente a cada vez. Se você tem um fluxo de trabalho fixo, pode escrevê-lo como uma Skill e, depois, executar todo o processo com um único comando.
Primeiro, deixe-me explicar o que é uma Skill. Simplificando, uma Skill é um script fixo que você escreve antecipadamente para a IA. Você inclui todas as regras, fluxos de trabalho e requisitos de formatação. Então, cada vez que você emite um comando, a IA executa de acordo com esse script, sem precisar de explicações repetidas. Se você já usou o Claude Code, uma Skill corresponde ao comando /skill-name.
Aqui estão alguns cenários em que uso Skills para processar arquivos do Obsidian:
Vídeo para texto: Vídeos do Bilibili ou locais, extrair áudio, transcrever para texto, organizar em notas do Obsidian e colocar diretamente na pasta de entrada.
Adicionar links bidirecionais: Depois de escrever uma nova nota, fazer a IA escanear as notas existentes e adicionar [[links bidirecionais]] ao conteúdo relacionado, tecendo a rede de informações.
Escrever artigos: Dado um tópico, a IA pesquisa materiais, confirma a direção do tópico, aprende meu estilo de escrita, escreve um rascunho, revisa e reduz a artificialidade da IA, adiciona imagens e, finalmente, gera o artigo na pasta 04Output/.
Revisão e verificação de fatos: Jogar um rascunho pronto para a IA, pedir que ela verifique parágrafo por parágrafo em busca de erros, problemas de lógica e afirmações que valham a pena verificar.
Essas tarefas costumavam ser feitas manualmente, dispersas e demoradas. Com Skills, um único comando faz a IA executar todo o processo, e você só precisa confirmar nos pontos-chave.
Conceitos sozinhos são muito abstratos. Vamos ver um exemplo concreto de uma Skill.
Criei uma Skill de escrita para o WeChat Official Account para a pasta 04Output/, cobrindo o processo completo de escrita, desde a escolha do tópico até a publicação. Veja como funciona:
Passo 1: Encontrar tópicos. A IA pode pesquisar no Reddit, Hacker News e X por tópicos recentes em alta sobre IA, finanças e tecnologia, e listar vários tópicos candidatos para você escolher.
Passo 2: Pesquisar materiais. Após confirmar o tópico, a IA automaticamente busca informações relevantes dos últimos dois anos, organiza em arquivos de base de conhecimento e os salva.
Passo 3: Discutir direção. A IA oferece de 3 a 4 ângulos de escrita e esboços correspondentes para você escolher. Você confirma antes de prosseguir.
Passo 4: Aprender estilo e escrever rascunho. Vários modos para escolher: ler seus próprios artigos publicados para aprender seu estilo, aplicar modelos de estilo de autores como Jiubian ou Huashu, ou especificar um artigo para extrair características de estilo na hora. Após aprender o estilo, escrever o rascunho.
Passo 5: Revisar. Três passagens: precisão do conteúdo, reduzir a artificialidade da IA (substituir frases como “vale a pena notar”, “capacitar”, “em resumo”) e polir detalhes de frases e parágrafos.
Passo 6: Adicionar imagens e publicar. Inserir placeholders de imagem e, se necessário, enviar diretamente para a caixa de rascunho do WeChat Official Account.
Durante todo o processo, a IA usa o Obsidian CLI para operar sua pasta: pesquisar notas existentes como materiais, salvar resumos e arquivos de base de conhecimento em diretórios especificados, gerar o artigo final em 04Output/ e definir propriedades do frontmatter. Você não precisa mover nenhum arquivo manualmente.
A captura de tela abaixo mostra como é quando eu emito um comando de escrita para a IA:
Este é apenas um exemplo para a pasta 04Output/. Você pode criar suas próprias Skills para qualquer pasta: uma Skill para organizar notas de leitura, uma Skill para resumir atas de reunião, uma Skill para revisar diários… Desde que você consiga descrever claramente “o que quero que a IA faça por mim nesta pasta”, você pode escrever como uma Skill.
Disponibilizei esta Skill de escrita para o WeChat Official Account como código aberto. Se precisar, você pode baixá-la diretamente do meu blog: https://blog.discoverlabs.ac.cn/downloads/writing-gongzhonghao-skill/
Resumo
O que você aprendeu hoje:
- O método mais simples: dar diretamente o caminho do arquivo para a IA, ela pode ler e processar o arquivo original — resumo, tradução, modificação, tudo funciona
- Obsidian CLI: Quando seu cofre tem muitos arquivos, a CLI dá à IA um “sistema de recuperação de biblioteca” para encontrar informações com mais precisão e rapidez
- Skill: Escrever um fluxo de trabalho fixo como um script, executar todo o processo com um comando, adequado para fluxos de trabalho repetitivos
Pontos-chave:
- Os três métodos aumentam em dificuldade e automação; escolha de acordo com suas necessidades
- A combinação de CLI + Skill é a verdadeira integração profunda entre IA e Obsidian
- Você não precisa escrever uma Skill do zero; pode pedir para a IA escrevê-la para você