PARE. LEIA ESTE SKILL.MD COMPLETO ANTES DE CHAMAR QUALQUER ENDPOINT.
Habilidade arXiv
Pesquise no arXiv e extraia conhecimento para a memória.
Comandos
| Comando | Descrição |
|---|---|
search | Encontrar artigos (retorna abstracts para triagem) |
learn | Extrair conhecimento para a memória |
download | Baixar HTML do artigo por padrão; arquivos de saída são nomeados a partir do título do artigo |
OBRIGATÓRIO: Geração de Contexto Dinâmico
NÃO NEGOCIÁVEL: Antes de QUALQUER operação arxiv, o agente DEVE gerar um arquivo de contexto dinâmico que capture os objetivos atuais da colaboração.
Por que isso é necessário
Sem contexto dinâmico:
- A busca retorna artigos tangencialmente relacionados
- A triagem de abstracts carece de critérios claros de relevância
- O conhecimento extraído é genérico ("O que o artigo diz sobre X?")
Com contexto dinâmico:
- A busca é direcionada a necessidades específicas de implementação
- A avaliação de abstracts tem critérios claros de aceitação/rejeição
- O conhecimento extraído é acionável ("Como implementar X como código")
Fluxo de Trabalho: Descoberta de Artigos com Contexto Primeiro
0. CONTEXTO → Gerar contexto dinâmico a partir da conversa (OBRIGATÓRIO)
1. BUSCAR → Usar contexto para encontrar artigos relevantes
2. TRIAGEM → Avaliar abstracts contra os objetivos do contexto
3. DECIDIR → Usuário escolhe quais artigos extrair
4. APRENDER → Extrair com contexto para blocos de conhecimento focados
Passo 0: Gerar Contexto Dinâmico (OBRIGATÓRIO)
Antes de buscar, o agente DEVE criar /tmp/arxiv_context.md com:
# Contexto de Pesquisa: [Seu Objetivo Específico]
## O Que Estamos Construindo
[Descreva o recurso/sistema específico, ex.: "Teoria da Mente para o agente Horus"]
## Estado Atual
[O que já existe, o que está implementado, o que temos]
## O Que Precisamos dos Artigos
1. [Pergunta específica 1, ex.: "Como representar confiança de crença como estrutura de dados"]
2. [Pergunta específica 2, ex.: "Quando acionar reflexão contrafactual"]
3. [Pergunta específica 3, ex.: "Algoritmo para atualizar crenças em contradição"]
## Termos de Busca para Tentar
- [termo 1]
- [termo 2]
## Critérios de Relevância para Triagem de Abstracts
- ALTA: Artigos que abordam diretamente [necessidade específica]
- MÉDIA: Artigos com técnicas relacionadas que podem se adaptar
- BAIXA: Tangencialmente relacionados, pule a menos que não haja nada melhor
## Foco da Extração de Conhecimento
- Extrair: [tipo de conhecimento, ex.: "algoritmos, estruturas de dados, regras de atualização"]
- Pular: [o que ignorar, ex.: "métricas de avaliação, descrições de conjuntos de dados, trabalhos futuros"]
## Preferência de Formato de Saída
Formule como problemas de implementação, não resumos:
- RUIM: "O que o artigo diz sobre X?"
- BOM: "Como devemos implementar X? Qual padrão de código?"
Passo 1: Buscar com Contexto
Após criar o contexto, use-o para guiar a busca:
# Busca guiada pelos objetivos do contexto
./run.sh search -q "theory of mind BDI agent belief tracking" -n 10
Passo 2: Triagem Contra o Contexto
Avalie cada abstract contra os critérios de relevância do contexto:
## Artigos Encontrados - Avaliando Contra Objetivos do Contexto
### 1. **Título do Artigo** (arXiv:XXXX.XXXXX)
> [Abstract]
**Em relação ao contexto:**
- Aborda objetivo 1 (representação de crença): SIM - descreve estrutura BDI dict
- Aborda objetivo 2 (reflexão contrafactual): NÃO
- **Veredito: ALTA** - responde diretamente nossa pergunta sobre estrutura de dados
### 2. **Título do Artigo** (arXiv:XXXX.XXXXX)
> [Abstract]
**Em relação ao contexto:**
- Aborda objetivo 1: NÃO
- Aborda objetivo 2: SIM - descreve condições de acionamento de reflexão
- **Veredito: ALTA** - responde diretamente nossa pergunta sobre algoritmo
---
Quais artigos devo extrair?
Passo 3: Extrair com Arquivo de Contexto
Passe o arquivo de contexto para learn para extração focada:
./run.sh learn 2501.15355 --scope persona-research --context-file /tmp/arxiv_context.md
NÃO prossiga sem confirmação do usuário sobre a seleção do artigo.
search - Encontrar Artigos
./run.sh search -q "agent memory" -n 5
Retorna artigos com abstracts completos para triagem rápida.
| Opção | Descrição |
|---|---|
-q | Consulta de busca (obrigatório) |
-n | Máximo de resultados (padrão: 10) |
-c | Filtro de categoria (ex.: cs.LG) |
-m | Artigos dos últimos N meses |
--smart | LLM traduz consulta em linguagem natural |
learn - Extrair Conhecimento
./run.sh learn 2601.08058 --scope memory
Pipeline completo: download → perfil → extrair → Q&A → entrevista → armazenar → verificar arestas.
| Opção | Descrição |
|---|---|
--scope | Escopo da memória (obrigatório) |
--context | Foco de domínio para relevância |
--dry-run | Visualizar sem armazenar |
--skip-interview | Autoaceitar recomendações |
--accurate | Forçar extração PDF + VLM |
--mode | Modo de entrevista: auto, html, tui (padrão: auto) |
Modo de Extração (HTML-Primeiro)
NOVO: O comando learn agora usa extração HTML-primeiro por padrão:
- Baixa HTML de ar5iv.org (artigos arxiv convertidos para HTML limpo)
- Executa verificação rápida de perfil (conta figuras/tabelas)
- Roteia para o modo de extração apropriado
arxiv learn <id>
│
├── modo rápido (padrão) ──► ar5iv HTML ──► extrator HTML
│ - A maioria dos artigos de pesquisa (paridade de extração 100%)
│ - Conteúdo com muito texto (sem problemas de colunas PDF)
│
└── modo preciso ──► arxiv PDF ──► extrator PDF + VLM
- Artigos onde figuras são críticas
- Tabelas complexas com valores precisos
- Uso: flag --accurate
Por que HTML-Primeiro?
| Aspecto | HTML (ar5iv) | |
|---|---|---|
| Qualidade de extração | Paridade 100% | ~87% (problemas de detecção de colunas) |
| Velocidade | Rápido (~5s) | Mais lento (~30s-2min) |
| Legendas de figuras | Incluídas | Requer VLM |
| Renderização matemática | MathML preservado | Aproximação textual |
| Problemas de layout | Nenhum | Problemas de detecção de 2 colunas |
ar5iv.org converte fonte LaTeX do arxiv para HTML semântico com equações MathML e estrutura adequada. Isso elimina problemas de extração de PDF.
Quando Usar --accurate
| Tipo de Conteúdo | Modo Recomendado | Por quê |
|---|---|---|
| A maioria dos artigos de pesquisa | padrão (HTML) | Texto + legendas são suficientes |
| Artigos de revisão | padrão (HTML) | Cobertura ampla, figuras exatas não são críticas |
| Artigos com diagramas críticos | --accurate | Quando o conteúdo visual É o ponto |
| Artigos com tabelas de dados complexas | --accurate | Quando números precisos importam |
# Padrão: Extração HTML (rápida, confiável)
./run.sh learn 2601.10025 --scope persona-research
# Forçar modo preciso para artigos com muitas figuras
./run.sh learn 2501.15355 --scope tom-research --accurate
Roteamento Baseado em Perfil
A habilidade automaticamente cria perfil do HTML baixado para sugerir o modo de extração:
- < 20 figuras E < 10 tabelas: Usa HTML (modo rápido)
- > 20 figuras OU > 10 tabelas: Sugere modo preciso (ou use
--accurate)
A saída do perfil aparece nos logs:
Perfil: 12 figuras, 4 tabelas → Usando extração HTML (modo rápido)
Caminho Feliz
# 1. Buscar - obter abstracts
./run.sh search -q "agent memory systems" -n 5
# 2. PARE - discutir abstracts com o usuário, avaliar relevância
# 3. Aprender - extrair artigos selecionados pelo usuário (extração HTML por padrão)
./run.sh learn 2601.10702 --scope memory --context "agent systems"
Exemplos
Pesquisa de Levantamento (extração HTML - padrão)
./run.sh learn 2601.10025 --scope persona-research --context "LLM personality"
Artigo com Figuras Críticas (modo preciso)
./run.sh learn 2501.15355 --scope tom-research --context "BDI architecture" --accurate
Teste de Simulação Primeiro
# Visualizar o que seria extraído
./run.sh learn 2601.10025 --scope test --dry-run
Baixar Apenas HTML
# Baixar ar5iv HTML para inspeção manual (padrão; nome de arquivo baseado no título)
./run.sh download -i 2501.15355
# Baixar PDF apenas quando necessário
./run.sh download -i 2501.15355 --format pdf
Processamento em Lote (Paralelo)
# Processar vários artigos em paralelo (padrão: 2 concorrentes)
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope tom-research --context-file /tmp/context.md
# Aumentar paralelismo para processamento mais rápido
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope research --parallel 3
# Teste de simulação para visualizar
./run.sh batch 2501.15355 2502.14171 --scope test --dry-run
| Opção | Descrição |
|---|---|
--parallel N | Máximo de artigos para processar concorrentemente (padrão: 2) |
--context-file | Arquivo de contexto rico para extração focada |
--skip-interview | Autoaceitar (padrão para lote) |
--dry-run | Visualizar sem armazenar |
Nota: O paralelismo recomendado é de 2 a 3 artigos. Valores maiores podem atingir limites de taxa da API.
Erros Comuns
ERRADO: Buscar sem criar contexto primeiro
./run.sh search -q "agent memory" -n 10
CORRETO: Gerar /tmp/arxiv_context.md DEPOIS buscar
# 1. Escrever arquivo de contexto com objetivos específicos e critérios de relevância
# 2. Depois buscar guiado pelo contexto
./run.sh search -q "agent memory BDI belief tracking" -n 10
ERRADO: Extrair artigos sem confirmação do usuário
# Agente extrai automaticamente todos os 10 resultados da busca
./run.sh learn 2501.15355 --scope research
./run.sh learn 2502.14171 --scope research
CORRETO: Apresentar abstracts, deixar usuário escolher, depois extrair
./run.sh search -q "agent memory" -n 10
# PARE - discutir abstracts com usuário, avaliar relevância
# Usuário escolhe artigos 2 e 5
./run.sh learn 2501.15355 --scope research --context-file /tmp/arxiv_context.md
ERRADO: Usar --accurate para artigos com muito texto
./run.sh learn 2601.10025 --scope research --accurate # perde tempo com extração PDF
CORRETO: Modo HTML padrão para a maioria dos artigos, --accurate apenas para os com muitas figuras
./run.sh learn 2601.10025 --scope research # HTML é mais rápido e confiável
Dependências
| Componente | URL | Propósito |
|---|---|---|
| ar5iv.org | https://ar5iv.org | Conversão de LaTeX para HTML para artigos arxiv |
| habilidade extractor | (habilidade irmã) | Extração de conteúdo HTML/PDF |
| habilidade qra | (habilidade irmã) | Geração de pares Q&A a partir de texto |
Nota de recuperação de falha de treinamento QRA (2026-09-14)
Observado durante pesquisa qra-training: download --format html falhou quando
a API de metadados do arXiv retornou 429 ou excedeu o tempo limite antes da etapa
de download HTML/PDF. O CLI agora trata a consulta de metadados como opcional para
IDs de artigo diretos. Se os metadados falharem, ele constrói URLs de fallback
diretos e tenta, nesta ordem:
https://arxiv.org/html/<id-com-versao>https://arxiv.org/html/<id-base>https://ar5iv.org/abs/<id-base>https://ar5iv.labs.arxiv.org/html/<id-base>
Uma falha de metadados deve aparecer em warnings[], não em errors[], quando uma
dessas URLs de conteúdo for bem-sucedida.