Criador de Templates para Obsidian Web Clipper

Esta habilidade ajuda você a criar templates JSON importáveis para o Obsidian Web Clipper.

Quando Usar

• Você precisa criar ou refinar um template importável para o Obsidian Web Clipper.
• Você quer mapear o DOM real de um site, dados de schema e seletores em um template de clipping válido.
• Você precisa de verificação de seletores e orientação sobre a lógica do template antes de entregar o JSON ao usuário.

Fluxo de Trabalho

1. Identificar Intenção do Usuário: site específico (YouTube), tipo específico (Receita) ou clipping geral?
2. Verificar Bases Existentes: O usuário provavelmente tem um schema "Base" definido em Bases/.
   • Ação: Ler Bases/*.base para encontrar uma categoria correspondente (ex: Recipes.base).
   • Ação: Usar as propriedades definidas na Base para estruturar as propriedades do template do Clipper.
   • Veja references/bases-workflow.md para detalhes.
3. Buscar e Analisar URL de Referência: Validar variáveis contra uma página real.
   • Ação: Pedir ao usuário um URL de exemplo do conteúdo que ele deseja recortar (se não fornecido).
   • Ação (OBRIGATÓRIO): Usar WebFetch para recuperar o conteúdo da página; se WebFetch não estiver disponível, usar um snapshot do DOM do navegador. Veja references/analysis-workflow.md.
   • Ação: Analisar o HTML em busca de JSON Schema.org, Meta tags e seletores CSS.
   • Ação (OBRIGATÓRIO): Verificar cada seletor contra o conteúdo buscado. Não adivinhe seletores.
   • Veja references/analysis-workflow.md para técnicas de análise.
4. Esboçar o JSON: Criar um objeto JSON válido seguindo o schema.
   • Veja references/json-schema.md.
5. Considerar a lógica do template: Usar condicionais para blocos opcionais (ex: mostrar nutrição apenas se presente), loops para dados de lista, atribuição de variáveis para evitar expressões repetidas e fallbacks para variáveis ausentes. Use lógica apenas quando melhorar o template; mantenha templates simples, simples. Veja references/logic.md.
6. Verificar Variáveis: Garantir que as variáveis escolhidas (Preset, Schema, Seletor) existam em sua análise.
   • Ação (OBRIGATÓRIO): Se um seletor não puder ser verificado a partir do conteúdo buscado, declare isso explicitamente e peça outro URL.
   • Veja references/variables.md.

Regras de Verificação de Seletores

• Sempre verifique os seletores contra o conteúdo da página ao vivo antes de responder.
• Nunca adivinhe seletores. Se o DOM não puder ser acessado ou o elemento estiver faltando, peça outro URL ou uma captura de tela.
• Prefira seletores estáveis (atributos de dados, papéis semânticos, IDs únicos) em vez de cadeias de classes frágeis.
• Documente o elemento alvo em seu raciocínio (ex: "Parágrafo da barra lateral Sobre") para reduzir incompatibilidades.

Formato de Saída

SEMPRE gere o resultado final como um bloco de código JSON que o usuário pode copiar e importar.

O editor de templates do Clipper valida a sintaxe do template. Se você usar lógica de template (condicionais, loops, atribuição de variáveis), certifique-se de que ela siga a sintaxe em references/logic.md e a documentação oficial de Logic para que o template passe na validação.

{
  "schemaVersion": "0.1.0",
  "name": "My Template",
  ...
}

Recursos

• references/variables.md - Variáveis de dados disponíveis.
• references/filters.md - Filtros de formatação.
• references/json-schema.md - Documentação da estrutura JSON.
• references/logic.md - Lógica do template.
• references/bases-workflow.md - Como mapear Bases para Templates.
• references/analysis-workflow.md - Como validar dados da página.

Documentação Oficial

• Variables
• Filters
• Logic
• Templates

Exemplos

Veja assets/ para exemplos de JSON.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.