Análise de Literatura
Visão Geral
Conduza análises críticas sistemáticas e abrangentes de literatura seguindo metodologia acadêmica rigorosa. Busque em múltiplos bancos de dados bibliográficos, sintetize achados tematicamente, verifique todas as citações quanto à precisão e gere documentos de saída profissionais em formatos markdown e PDF.
Esta competência se integra com múltiplas competências científicas para acesso a bancos de dados (gget, bioservices, datacommons-client) e fornece ferramentas especializadas para verificação de citações, agregação de resultados e geração de documentos.
Quando Usar Esta Competência
Use esta competência quando:
- Conduzir uma análise crítica sistemática de literatura para pesquisa ou publicação
- Sintetizar conhecimento atual sobre um tópico específico entre múltiplas fontes
- Realizar meta-análise ou revisões de escopo
- Escrever a seção de análise de literatura de um artigo de pesquisa ou tese
- Investigar o estado da arte em um domínio de pesquisa
- Identificar lacunas de pesquisa e direções futuras
- Exigir citações verificadas e formatação profissional
Aprimoramento Visual com Esquemas Científicos
⚠️ OBRIGATÓRIO: Toda análise de literatura DEVE incluir pelo menos 1-2 figuras geradas por IA usando a competência scientific-schematics.
Isto não é opcional. Análises de literatura sem elementos visuais estão incompletas. Antes de finalizar qualquer documento:
- Gere no mínimo UM esquema ou diagrama (p. ex., diagrama de fluxo PRISMA para revisões sistemáticas)
- Prefira 2-3 figuras para revisões abrangentes (fluxograma de estratégia de busca, diagrama de síntese temática, marco conceitual)
Como gerar figuras:
- Use a competência scientific-schematics para gerar diagramas de qualidade para publicação com IA
- Simplesmente descreva o diagrama desejado em linguagem natural
- Nano Banana Pro gerará, revisará e refinará automaticamente o esquema
Como gerar esquemas:
python scripts/generate_schematic.py "descrição do diagrama" -o figures/output.png
A IA gerará automaticamente:
- Imagens de qualidade para publicação com formatação apropriada
- Revisão e refinamento através de múltiplas iterações
- Garantia de acessibilidade (amigável para daltônicos, alto contraste)
- Salvamento de saídas no diretório figures/
Quando adicionar esquemas:
- Diagramas de fluxo PRISMA para revisões sistemáticas
- Fluxogramas de estratégia de busca bibliográfica
- Diagramas de síntese temática
- Mapas de visualização de lacunas de pesquisa
- Diagramas de redes de citações
- Ilustrações de marcos conceituais
- Qualquer conceito complexo que se beneficie de visualização
Para orientação detalhada sobre criação de esquemas, consulte a documentação da competência scientific-schematics.
Fluxo de Trabalho Principal
As análises de literatura seguem um fluxo de trabalho estruturado e multifásico:
Fase 1: Planejamento e Delimitação de Escopo
Defina a Pergunta de Pesquisa: Use framework PICO (População, Intervenção, Comparação, Outcome) para revisões clínicas/biomédicas
- Exemplo: "Qual é a eficácia do CRISPR-Cas9 (I) para tratar doença falciforme (P) em comparação com cuidados padrão (C)?"
Estabeleça Escopo e Objetivos:
- Defina perguntas de pesquisa claras e específicas
- Determine tipo de revisão (narrativa, sistemática, escopo, meta-análise)
- Estabeleça limites (período de tempo, escopo geográfico, tipos de estudo)
Desenvolva Estratégia de Busca:
- Identifique 2-4 conceitos principais da pergunta de pesquisa
- Liste sinônimos, abreviaturas e termos relacionados para cada conceito
- Planeje operadores booleanos (AND, OR, NOT) para combinar termos
- Selecione no mínimo 3 bancos de dados complementares
Estabeleça Critérios de Inclusão/Exclusão:
- Intervalo de datas (p. ex., últimos 10 anos: 2015-2024)
- Idioma (tipicamente inglês, ou especifique multilíngue)
- Tipos de publicação (revisados por pares, preprints, revisões)
- Desenhos de estudo (RCTs, observacionais, in vitro, etc.)
- Documente todos os critérios claramente
Fase 2: Busca Sistemática de Literatura
Busca em Múltiplos Bancos de Dados:
Selecione bancos de dados apropriados para o domínio:
Biomédica & Ciências da Vida:
- Use competência
gget: gget search pubmed "termos de busca" para PubMed/PMC
- Use competência
gget: gget search biorxiv "termos de busca" para preprints
- Use competência
bioservices para ChEMBL, KEGG, UniProt, etc.
Literatura Científica Geral:
- Busque arXiv via API direta (preprints em física, matemática, CS, q-bio)
- Busque Semantic Scholar via API (200M+ artigos, multidisciplinar)
- Use Google Scholar para cobertura abrangente (manual ou scraping cuidadoso)
Bancos de Dados Especializados:
- Use
gget alphafold para estruturas de proteínas
- Use
gget cosmic para genômica do câncer
- Use
datacommons-client para dados demográficos/estatísticos
- Use bancos de dados especializados conforme apropriado para o domínio
Documente Parâmetros de Busca:
## Estratégia de Busca
### Banco de Dados: PubMed
- **Data pesquisada**: 2024-10-25
- **Intervalo de datas**: 2015-01-01 a 2024-10-25
- **String de busca**:
("CRISPR"[Title] OR "Cas9"[Title])
AND ("sickle cell"[MeSH] OR "SCD"[Title/Abstract])
AND 2015:2024[Publication Date]
- **Resultados**: 247 artigos
Repita para cada banco de dados pesquisado.
Exporte e Agregue Resultados:
Fase 3: Triagem e Seleção
Deduplicação:
python search_databases.py results.json --deduplicate --output unique_results.json
- Remove duplicatas por DOI (primário) ou título (fallback)
- Documente número de duplicatas removidas
Triagem de Títulos:
- Revise todos os títulos contra critérios de inclusão/exclusão
- Exclua estudos obviamente irrelevantes
- Documente número excluído nesta fase
Triagem de Resumos:
- Leia resumos dos estudos restantes
- Aplique critérios de inclusão/exclusão rigorosamente
- Documente razões de exclusão
Triagem de Texto Completo:
- Obtenha textos completos dos estudos restantes
- Conduza revisão detalhada contra todos os critérios
- Documente razões específicas de exclusão
- Registre número final de estudos incluídos
Crie Diagrama de Fluxo PRISMA:
Busca inicial: n = X
├─ Após deduplicação: n = Y
├─ Após triagem de títulos: n = Z
├─ Após triagem de resumos: n = A
└─ Incluído na revisão: n = B
Fase 4: Extração de Dados e Avaliação de Qualidade
Extraia Dados Principais de cada estudo incluído:
- Metadados do estudo (autores, ano, periódico, DOI)
- Desenho e métodos do estudo
- Tamanho da amostra e características populacionais
- Achados principais e resultados
- Limitações observadas pelos autores
- Fontes de financiamento e conflitos de interesse
Avalie Qualidade do Estudo:
- Para RCTs: Use ferramenta Cochrane Risk of Bias
- Para estudos observacionais: Use Newcastle-Ottawa Scale
- Para revisões sistemáticas: Use AMSTAR 2
- Classifique cada estudo: Qualidade Alta, Moderada, Baixa ou Muito Baixa
- Considere excluir estudos de qualidade muito baixa
Organize por Temas:
- Identifique 3-5 temas principais entre estudos
- Agrupe estudos por tema (estudos podem aparecer em múltiplos temas)
- Observe padrões, consenso e controvérsias
Fase 5: Síntese e Análise
Crie Documento de Revisão a partir do template:
cp assets/review_template.md minha_analise_literatura.md
Escreva Síntese Temática (NÃO sumários estudo-por-estudo):
- Organize seção de Resultados por temas ou perguntas de pesquisa
- Sintetize achados entre múltiplos estudos dentro de cada tema
- Compare e contraste diferentes abordagens e resultados
- Identifique áreas de consenso e pontos de controvérsia
- Destaque a evidência mais forte
Exemplo de estrutura:
#### 3.3.1 Tema: Métodos de Entrega de CRISPR
Múltiplas abordagens de entrega foram investigadas para edição gênica
terapêutica. Vetores virais (AAV) foram usados em 15 estudos^1-15^ e
mostraram alta eficiência de transdução (65-85%), mas levantaram
preocupações de imunogenicidade^3,7,12^. Em contraste, nanopartículas
lipídicas demonstraram eficiência menor (40-60%), mas perfis de segurança
melhorados^16-23^.
Análise Crítica:
- Avalie forças metodológicas e limitações entre estudos
- Avalie qualidade e consistência de evidência
- Identifique lacunas de conhecimento e metodológicas
- Observe áreas que exigem futuras pesquisas
Escreva Discussão:
- Interprete achados em contexto mais amplo
- Discuta implicações clínicas, práticas ou de pesquisa
- Reconheça limitações da própria revisão
- Compare com revisões anteriores se aplicável
- Proponha direções específicas de pesquisa futura
Fase 6: Verificação de Citações
CRÍTICO: Todas as citações devem ser verificadas quanto à precisão antes da submissão final.
Verifique Todos os DOIs:
python scripts/verify_citations.py minha_analise_literatura.md
Este script:
- Extrai todos os DOIs do documento
- Verifica cada DOI se resolve corretamente
- Recupera metadados de CrossRef
- Gera relatório de verificação
- Produz citações devidamente formatadas
Revise Relatório de Verificação:
- Verifique DOIs que falharam
- Valide nomes de autores, títulos e detalhes de publicação correspondem
- Corrija erros no documento original
- Re-execute verificação até que todas as citações passem
Formate Citações Consistentemente:
- Escolha um estilo de citação e use em todo o documento (consulte
references/citation_styles.md)
- Estilos comuns: APA, Nature, Vancouver, Chicago, IEEE
- Use saída do script de verificação para formatar citações corretamente
- Garanta que citações no texto correspondem ao formato da lista de referências
Fase 7: Geração de Documento
Gere PDF:
python scripts/generate_pdf.py minha_analise_literatura.md \
--citation-style apa \
--output minha_revisao.pdf
Opções:
--citation-style: apa, nature, chicago, vancouver, ieee
--no-toc: Desabilite sumário
--no-numbers: Desabilite numeração de seções
--check-deps: Verifique se pandoc/xelatex estão instalados
Revise Saída Final:
- Verifique formatação e layout do PDF
- Valide que todas as seções estão presentes
- Garanta que citações renderizam corretamente
- Verifique que figuras/tabelas aparecem adequadamente
- Valide que sumário está correto
Checklist de Qualidade:
Orientação Específica por Banco de Dados
PubMed / PubMed Central
Acesse via competência gget:
# Busque PubMed
gget search pubmed "CRISPR gene editing" -l 100
# Busque com filtros
# Use PubMed Advanced Search Builder para construir consultas complexas
# Depois execute via gget ou API Entrez direta
Dicas de busca:
- Use termos MeSH:
"sickle cell disease"[MeSH]
- Tags de campo:
[Title], [Title/Abstract], [Author]
- Filtros de data:
2020:2024[Publication Date]
- Operadores booleanos: AND, OR, NOT
- Consulte navegador MeSH: https://meshb.nlm.nih.gov/search
bioRxiv / medRxiv
Acesse via competência gget:
gget search biorxiv "CRISPR sickle cell" -l 50
Considerações importantes:
- Preprints não são revisados por pares
- Valide achados com cautela
- Verifique se preprint foi publicado (CrossRef)
- Observe versão e data do preprint
arXiv
Acesse via API direta ou WebFetch:
# Exemplo categorias de busca:
# q-bio.QM (Métodos Quantitativos)
# q-bio.GN (Genômica)
# q-bio.MN (Redes Moleculares)
# cs.LG (Machine Learning)
# stat.ML (Estatística Machine Learning)
# Formato de busca: categoria AND termos
search_query = "cat:q-bio.QM AND ti:\"single cell sequencing\""
Semantic Scholar
Acesse via API direta (requer chave API, ou use tier gratuito):
- 200M+ artigos em todos os campos
- Excelente para buscas multidisciplinares
- Fornece grafos de citações e recomendações de artigos
- Use para encontrar artigos altamente influentes
Bancos de Dados Biomédicos Especializados
Use competências apropriadas:
- ChEMBL: Competência
bioservices para bioatividade química
- UniProt: Competência
gget ou bioservices para informações de proteínas
- KEGG: Competência
bioservices para vias e genes
- COSMIC: Competência
gget para mutações em câncer
- AlphaFold:
gget alphafold para estruturas de proteínas
- PDB:
gget ou API direta para estruturas experimentais
Encadeamento de Citações
Expanda busca via redes de citações:
Citações diretas (artigos que citam artigos principais):
- Use Google Scholar "Citado por"
- Use APIs Semantic Scholar ou OpenAlex
- Identifica pesquisa mais nova construindo sobre trabalho seminal
Citações reversas (referências de artigos principais):
- Extraia referências de artigos incluídos
- Identifique trabalho fundacional altamente citado
- Encontre artigos citados por múltiplos estudos incluídos
Guia de Estilo de Citação
Orientação detalhada de formatação está em references/citation_styles.md. Referência rápida:
APA (7ª Edição)
- No texto: (Smith et al., 2023)
- Referência: Smith, J. D., Johnson, M. L., & Williams, K. R. (2023). Título. Periódico, 22(4), 301-318. https://doi.org/10.xxx/yyy
Nature
- No texto: Números sobrescritos^1,2^
- Referência: Smith, J. D., Johnson, M. L. & Williams, K. R. Título. Nat. Rev. Drug Discov. 22, 301-318 (2023).
Vancouver
- No texto: Números sobrescritos^1,2^
- Referência: Smith JD, Johnson ML, Williams KR. Título. Nat Rev Drug Discov. 2023;22(4):301-18.
Sempre verifique citações com verify_citations.py antes de finalizar.
Melhores Práticas
Estratégia de Busca
- Use múltiplos bancos de dados (mínimo 3): Garante cobertura abrangente
- Inclua servidores de preprints: Captura achados mais recentes não publicados
- Documente tudo: Strings de busca, datas, contagens de resultados para reprodutibilidade
- Teste e refine: Execute buscas piloto, revise resultados, ajuste termos
Triagem e Seleção
- Use critérios claros: Documente critérios de inclusão/exclusão antes da triagem
- Triagem sistemática: Título → Resumo → Texto completo
- Documente exclusões: Registre razões para excluir estudos
- Considere triagem dupla: Para revisões sistemáticas, dois revisores triagem independentemente
Síntese
- Organize tematicamente: Agrupe por temas, NÃO por estudos individuais
- Sintetize entre estudos: Compare, contraste, identifique padrões
- Seja crítico: Avalie qualidade e consistência de evidência
- Identifique lacunas: Observe o que está faltando ou pouco estudado
Qualidade e Reprodutibilidade
- Avalie qualidade do estudo: Use ferramentas apropriadas de avaliação de qualidade
- Verifique todas as citações: Execute script verify_citations.py
- Documente metodologia: Forneça detalhe suficiente para outros reproduzirem
- Siga diretrizes: Use PRISMA para revisões sistemáticas
Escrita
- Seja objetivo: Apresente evidência justamente, reconheça limitações
- Seja sistemático: Siga template estruturado
- Seja específico: Inclua números, estatísticas, tamanhos de efeito quando disponível
- Seja claro: Use headings claros, fluxo lógico, organização temática
Armadilhas Comuns a Evitar
- Busca em banco de dados único: Perde artigos relevantes; sempre busque em múltiplos
- Sem documentação de busca: Torna revisão irreproduível; documente todas as buscas
- Sumário estudo-por-estudo: Falta síntese; organize tematicamente em vez disso
- Citações não verificadas: Leva a erros; sempre execute verify_citations.py
- Busca muito ampla: Produz milhares de resultados irrelevantes; refine com termos específicos
- Busca muito restrita: Perde artigos relevantes; inclua sinônimos e termos relacionados
- Ignora preprints: Perde achados mais recentes; inclua bioRxiv, medRxiv, arXiv
- Sem avaliação de qualidade: Trata toda evidência igualmente; avalie e reporte qualidade
- Viés de publicação: Apenas resultados positivos publicados; observe viés potencial
- Busca desatualizada: Campo evolui rapidamente; declare claramente data da busca
Exemplo de Fluxo de Trabalho
Fluxo de trabalho completo para análise de literatura biomédica:
# 1. Crie documento de revisão a partir do template
cp assets/review_template.md analise_crispr_celula_falciforme.md
# 2. Busque em múltiplos bancos de dados usando competências apropriadas
# - Use competência gget para PubMed, bioRxiv
# - Use acesso API direto para arXiv, Semantic Scholar
# - Exporte resultados em formato JSON
# 3. Agregue e processe resultados
python scripts/search_databases.py combined_results.json \
--deduplicate \
--rank citations \
--year-start 2015 \
--year-end 2024 \
--format markdown \
--output search_results.md \
--summary
# 4. Triagem de resultados e extração de dados
# - Triagem manual de títulos, resumos, textos completos
# - Extração de dados principais para o documento de revisão
# - Organização por temas
# 5. Escreva a revisão seguindo estrutura do template
# - Introdução com objetivos claros
# - Seção de metodologia detalhada
# - Resultados organizados tematicamente
# - Discussão crítica
# - Conclusões claras
# 6. Verifique todas as citações
python scripts/verify_citations.py analise_crispr_celula_falciforme.md
# Revise o relatório de citações
cat analise_crispr_celula_falciforme_citation_report.json
# Corrija citações que falharam e re-verifique
python scripts/verify_citations.py analise_crispr_celula_falciforme.md
# 7. Gere PDF profissional
python scripts/generate_pdf.py analise_crispr_celula_falciforme.md \
--citation-style nature \
--output analise_crispr_celula_falciforme.pdf
# 8. Revise saídas finais de markdown e PDF
Integração com Outras Competências
Esta competência trabalha de forma integrada com outras competências científicas:
Competências de Acesso a Bancos de Dados
- gget: PubMed, bioRxiv, COSMIC, AlphaFold, Ensembl, UniProt
- bioservices: ChEMBL, KEGG, Reactome, UniProt, PubChem
- datacommons-client: Dados demográficos, econômicos, estatísticas de saúde
Competências de Análise
- pydeseq2: RNA-seq expressão diferencial (para seções de métodos)
- scanpy: Análise single-cell (para seções de métodos)
- anndata: Dados single-cell (para seções de métodos)
- biopython: Análise de sequências (para seções de fundo)
Competências de Visualização
- matplotlib: Gere figuras e gráficos para revisão
- seaborn: Visualizações estatísticas
Competências de Escrita
- brand-guidelines: Aplique branding institucional ao PDF
- internal-comms: Adapte revisão para diferentes audiências
Recursos
Recursos Inclusos
Scripts:
scripts/verify_citations.py: Verifique DOIs e gere citações formatadas
scripts/generate_pdf.py: Converta markdown em PDF profissional
scripts/search_databases.py: Processe, deduplicar e formate resultados de busca
Referências:
references/citation_styles.md: Guia detalhado de formatação de citações (APA, Nature, Vancouver, Chicago, IEEE)
references/database_strategies.md: Estratégias abrangentes de busca em banco de dados
Assets:
assets/review_template.md: Template de análise de literatura completo com todas as seções
Recursos Externos
Diretrizes:
Ferramentas:
Estilos de Citação:
Dependências
Pacotes Python Obrigatórios
pip install requests # Para verificação de citações
Ferramentas de Sistema Obrigatórias
# Para geração de PDF
brew install pandoc # macOS
apt-get install pandoc # Linux
# Para LaTeX (geração PDF)
brew install --cask mactex # macOS
apt-get install texlive-xetex # Linux
Verifique dependências:
python scripts/generate_pdf.py --check-deps
Resumo
Esta competência de análise de literatura fornece:
- Metodologia sistemática seguindo melhores práticas acadêmicas
- Integração multi-banco de dados via competências científicas existentes
- Verificação de citações garantindo acurácia e credibilidade
- Saída profissional em formatos markdown e PDF
- Orientação abrangente cobrindo todo processo de revisão
- Garantia de qualidade com ferramentas de verificação e validação
- Reprodutibilidade através de requisitos de documentação detalhada
Conduza análises de literatura rigorosas e minuciosas que atendam padrões acadêmicos e forneçam síntese abrangente do conhecimento atual em qualquer domínio.
1---2name: literature-review3description: Conduzir análises críticas de literatura abrangentes e sistemáticas usando múltiplos bancos de dados acadêmicos (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.). Esta competência deve ser usada ao realizar revisões sistemáticas de literatura, meta-análises, síntese de pesquisa ou buscas bibliográficas abrangentes em domínios biomédicos, científicos e técnicos. Cria documentos markdown e PDFs com formatação profissional e citações verificadas em múltiplos estilos (APA, Nature, Vancouver, etc.).4---56# Análise de Literatura78## Visão Geral910Conduza análises críticas sistemáticas e abrangentes de literatura seguindo metodologia acadêmica rigorosa. Busque em múltiplos bancos de dados bibliográficos, sintetize achados tematicamente, verifique todas as citações quanto à precisão e gere documentos de saída profissionais em formatos markdown e PDF.1112Esta competência se integra com múltiplas competências científicas para acesso a bancos de dados (gget, bioservices, datacommons-client) e fornece ferramentas especializadas para verificação de citações, agregação de resultados e geração de documentos.1314## Quando Usar Esta Competência1516Use esta competência quando:17- Conduzir uma análise crítica sistemática de literatura para pesquisa ou publicação18- Sintetizar conhecimento atual sobre um tópico específico entre múltiplas fontes19- Realizar meta-análise ou revisões de escopo20- Escrever a seção de análise de literatura de um artigo de pesquisa ou tese21- Investigar o estado da arte em um domínio de pesquisa22- Identificar lacunas de pesquisa e direções futuras23- Exigir citações verificadas e formatação profissional2425## Aprimoramento Visual com Esquemas Científicos2627**⚠️ OBRIGATÓRIO: Toda análise de literatura DEVE incluir pelo menos 1-2 figuras geradas por IA usando a competência scientific-schematics.**2829Isto não é opcional. Análises de literatura sem elementos visuais estão incompletas. Antes de finalizar qualquer documento:301. Gere no mínimo UM esquema ou diagrama (p. ex., diagrama de fluxo PRISMA para revisões sistemáticas)312. Prefira 2-3 figuras para revisões abrangentes (fluxograma de estratégia de busca, diagrama de síntese temática, marco conceitual)3233**Como gerar figuras:**34- Use a competência **scientific-schematics** para gerar diagramas de qualidade para publicação com IA35- Simplesmente descreva o diagrama desejado em linguagem natural36- Nano Banana Pro gerará, revisará e refinará automaticamente o esquema3738**Como gerar esquemas:**39```bash40python scripts/generate_schematic.py "descrição do diagrama" -o figures/output.png41```4243A IA gerará automaticamente:44- Imagens de qualidade para publicação com formatação apropriada45- Revisão e refinamento através de múltiplas iterações46- Garantia de acessibilidade (amigável para daltônicos, alto contraste)47- Salvamento de saídas no diretório figures/4849**Quando adicionar esquemas:**50- Diagramas de fluxo PRISMA para revisões sistemáticas51- Fluxogramas de estratégia de busca bibliográfica52- Diagramas de síntese temática53- Mapas de visualização de lacunas de pesquisa54- Diagramas de redes de citações55- Ilustrações de marcos conceituais56- Qualquer conceito complexo que se beneficie de visualização5758Para orientação detalhada sobre criação de esquemas, consulte a documentação da competência scientific-schematics.5960---6162## Fluxo de Trabalho Principal6364As análises de literatura seguem um fluxo de trabalho estruturado e multifásico:6566### Fase 1: Planejamento e Delimitação de Escopo67681. **Defina a Pergunta de Pesquisa**: Use framework PICO (População, Intervenção, Comparação, Outcome) para revisões clínicas/biomédicas69 - Exemplo: "Qual é a eficácia do CRISPR-Cas9 (I) para tratar doença falciforme (P) em comparação com cuidados padrão (C)?"70712. **Estabeleça Escopo e Objetivos**:72 - Defina perguntas de pesquisa claras e específicas73 - Determine tipo de revisão (narrativa, sistemática, escopo, meta-análise)74 - Estabeleça limites (período de tempo, escopo geográfico, tipos de estudo)75763. **Desenvolva Estratégia de Busca**:77 - Identifique 2-4 conceitos principais da pergunta de pesquisa78 - Liste sinônimos, abreviaturas e termos relacionados para cada conceito79 - Planeje operadores booleanos (AND, OR, NOT) para combinar termos80 - Selecione no mínimo 3 bancos de dados complementares81824. **Estabeleça Critérios de Inclusão/Exclusão**:83 - Intervalo de datas (p. ex., últimos 10 anos: 2015-2024)84 - Idioma (tipicamente inglês, ou especifique multilíngue)85 - Tipos de publicação (revisados por pares, preprints, revisões)86 - Desenhos de estudo (RCTs, observacionais, in vitro, etc.)87 - Documente todos os critérios claramente8889### Fase 2: Busca Sistemática de Literatura90911. **Busca em Múltiplos Bancos de Dados**:9293 Selecione bancos de dados apropriados para o domínio:9495 **Biomédica & Ciências da Vida:**96 - Use competência `gget`: `gget search pubmed "termos de busca"` para PubMed/PMC97 - Use competência `gget`: `gget search biorxiv "termos de busca"` para preprints98 - Use competência `bioservices` para ChEMBL, KEGG, UniProt, etc.99100 **Literatura Científica Geral:**101 - Busque arXiv via API direta (preprints em física, matemática, CS, q-bio)102 - Busque Semantic Scholar via API (200M+ artigos, multidisciplinar)103 - Use Google Scholar para cobertura abrangente (manual ou scraping cuidadoso)104105 **Bancos de Dados Especializados:**106 - Use `gget alphafold` para estruturas de proteínas107 - Use `gget cosmic` para genômica do câncer108 - Use `datacommons-client` para dados demográficos/estatísticos109 - Use bancos de dados especializados conforme apropriado para o domínio1101112. **Documente Parâmetros de Busca**:112 ```markdown113 ## Estratégia de Busca114115 ### Banco de Dados: PubMed116 - **Data pesquisada**: 2024-10-25117 - **Intervalo de datas**: 2015-01-01 a 2024-10-25118 - **String de busca**:119 ```120 ("CRISPR"[Title] OR "Cas9"[Title])121 AND ("sickle cell"[MeSH] OR "SCD"[Title/Abstract])122 AND 2015:2024[Publication Date]123 ```124 - **Resultados**: 247 artigos125 ```126127 Repita para cada banco de dados pesquisado.1281293. **Exporte e Agregue Resultados**:130 - Exporte resultados em formato JSON de cada banco de dados131 - Combine todos os resultados em um único arquivo132 - Use `scripts/search_databases.py` para pós-processamento:133 ```bash134 python search_databases.py combined_results.json \135 --deduplicate \136 --format markdown \137 --output aggregated_results.md138 ```139140### Fase 3: Triagem e Seleção1411421. **Deduplicação**:143 ```bash144 python search_databases.py results.json --deduplicate --output unique_results.json145 ```146 - Remove duplicatas por DOI (primário) ou título (fallback)147 - Documente número de duplicatas removidas1481492. **Triagem de Títulos**:150 - Revise todos os títulos contra critérios de inclusão/exclusão151 - Exclua estudos obviamente irrelevantes152 - Documente número excluído nesta fase1531543. **Triagem de Resumos**:155 - Leia resumos dos estudos restantes156 - Aplique critérios de inclusão/exclusão rigorosamente157 - Documente razões de exclusão1581594. **Triagem de Texto Completo**:160 - Obtenha textos completos dos estudos restantes161 - Conduza revisão detalhada contra todos os critérios162 - Documente razões específicas de exclusão163 - Registre número final de estudos incluídos1641655. **Crie Diagrama de Fluxo PRISMA**:166 ```167 Busca inicial: n = X168 ├─ Após deduplicação: n = Y169 ├─ Após triagem de títulos: n = Z170 ├─ Após triagem de resumos: n = A171 └─ Incluído na revisão: n = B172 ```173174### Fase 4: Extração de Dados e Avaliação de Qualidade1751761. **Extraia Dados Principais** de cada estudo incluído:177 - Metadados do estudo (autores, ano, periódico, DOI)178 - Desenho e métodos do estudo179 - Tamanho da amostra e características populacionais180 - Achados principais e resultados181 - Limitações observadas pelos autores182 - Fontes de financiamento e conflitos de interesse1831842. **Avalie Qualidade do Estudo**:185 - **Para RCTs**: Use ferramenta Cochrane Risk of Bias186 - **Para estudos observacionais**: Use Newcastle-Ottawa Scale187 - **Para revisões sistemáticas**: Use AMSTAR 2188 - Classifique cada estudo: Qualidade Alta, Moderada, Baixa ou Muito Baixa189 - Considere excluir estudos de qualidade muito baixa1901913. **Organize por Temas**:192 - Identifique 3-5 temas principais entre estudos193 - Agrupe estudos por tema (estudos podem aparecer em múltiplos temas)194 - Observe padrões, consenso e controvérsias195196### Fase 5: Síntese e Análise1971981. **Crie Documento de Revisão** a partir do template:199 ```bash200 cp assets/review_template.md minha_analise_literatura.md201 ```2022032. **Escreva Síntese Temática** (NÃO sumários estudo-por-estudo):204 - Organize seção de Resultados por temas ou perguntas de pesquisa205 - Sintetize achados entre múltiplos estudos dentro de cada tema206 - Compare e contraste diferentes abordagens e resultados207 - Identifique áreas de consenso e pontos de controvérsia208 - Destaque a evidência mais forte209210 Exemplo de estrutura:211 ```markdown212 #### 3.3.1 Tema: Métodos de Entrega de CRISPR213214 Múltiplas abordagens de entrega foram investigadas para edição gênica215 terapêutica. Vetores virais (AAV) foram usados em 15 estudos^1-15^ e216 mostraram alta eficiência de transdução (65-85%), mas levantaram217 preocupações de imunogenicidade^3,7,12^. Em contraste, nanopartículas218 lipídicas demonstraram eficiência menor (40-60%), mas perfis de segurança219 melhorados^16-23^.220 ```2212223. **Análise Crítica**:223 - Avalie forças metodológicas e limitações entre estudos224 - Avalie qualidade e consistência de evidência225 - Identifique lacunas de conhecimento e metodológicas226 - Observe áreas que exigem futuras pesquisas2272284. **Escreva Discussão**:229 - Interprete achados em contexto mais amplo230 - Discuta implicações clínicas, práticas ou de pesquisa231 - Reconheça limitações da própria revisão232 - Compare com revisões anteriores se aplicável233 - Proponha direções específicas de pesquisa futura234235### Fase 6: Verificação de Citações236237**CRÍTICO**: Todas as citações devem ser verificadas quanto à precisão antes da submissão final.2382391. **Verifique Todos os DOIs**:240 ```bash241 python scripts/verify_citations.py minha_analise_literatura.md242 ```243244 Este script:245 - Extrai todos os DOIs do documento246 - Verifica cada DOI se resolve corretamente247 - Recupera metadados de CrossRef248 - Gera relatório de verificação249 - Produz citações devidamente formatadas2502512. **Revise Relatório de Verificação**:252 - Verifique DOIs que falharam253 - Valide nomes de autores, títulos e detalhes de publicação correspondem254 - Corrija erros no documento original255 - Re-execute verificação até que todas as citações passem2562573. **Formate Citações Consistentemente**:258 - Escolha um estilo de citação e use em todo o documento (consulte `references/citation_styles.md`)259 - Estilos comuns: APA, Nature, Vancouver, Chicago, IEEE260 - Use saída do script de verificação para formatar citações corretamente261 - Garanta que citações no texto correspondem ao formato da lista de referências262263### Fase 7: Geração de Documento2642651. **Gere PDF**:266 ```bash267 python scripts/generate_pdf.py minha_analise_literatura.md \268 --citation-style apa \269 --output minha_revisao.pdf270 ```271272 Opções:273 - `--citation-style`: apa, nature, chicago, vancouver, ieee274 - `--no-toc`: Desabilite sumário275 - `--no-numbers`: Desabilite numeração de seções276 - `--check-deps`: Verifique se pandoc/xelatex estão instalados2772782. **Revise Saída Final**:279 - Verifique formatação e layout do PDF280 - Valide que todas as seções estão presentes281 - Garanta que citações renderizam corretamente282 - Verifique que figuras/tabelas aparecem adequadamente283 - Valide que sumário está correto2842853. **Checklist de Qualidade**:286 - [ ] Todos os DOIs verificados com verify_citations.py287 - [ ] Citações formatadas consistentemente288 - [ ] Diagrama de fluxo PRISMA incluído (para revisões sistemáticas)289 - [ ] Metodologia de busca totalmente documentada290 - [ ] Critérios de inclusão/exclusão claramente declarados291 - [ ] Resultados organizados tematicamente (não estudo-por-estudo)292 - [ ] Avaliação de qualidade concluída293 - [ ] Limitações reconhecidas294 - [ ] Referências completas e precisas295 - [ ] PDF gerado sem erros296297## Orientação Específica por Banco de Dados298299### PubMed / PubMed Central300301Acesse via competência `gget`:302```bash303# Busque PubMed304gget search pubmed "CRISPR gene editing" -l 100305306# Busque com filtros307# Use PubMed Advanced Search Builder para construir consultas complexas308# Depois execute via gget ou API Entrez direta309```310311**Dicas de busca**:312- Use termos MeSH: `"sickle cell disease"[MeSH]`313- Tags de campo: `[Title]`, `[Title/Abstract]`, `[Author]`314- Filtros de data: `2020:2024[Publication Date]`315- Operadores booleanos: AND, OR, NOT316- Consulte navegador MeSH: https://meshb.nlm.nih.gov/search317318### bioRxiv / medRxiv319320Acesse via competência `gget`:321```bash322gget search biorxiv "CRISPR sickle cell" -l 50323```324325**Considerações importantes**:326- Preprints não são revisados por pares327- Valide achados com cautela328- Verifique se preprint foi publicado (CrossRef)329- Observe versão e data do preprint330331### arXiv332333Acesse via API direta ou WebFetch:334```python335# Exemplo categorias de busca:336# q-bio.QM (Métodos Quantitativos)337# q-bio.GN (Genômica)338# q-bio.MN (Redes Moleculares)339# cs.LG (Machine Learning)340# stat.ML (Estatística Machine Learning)341342# Formato de busca: categoria AND termos343search_query = "cat:q-bio.QM AND ti:\"single cell sequencing\""344```345346### Semantic Scholar347348Acesse via API direta (requer chave API, ou use tier gratuito):349- 200M+ artigos em todos os campos350- Excelente para buscas multidisciplinares351- Fornece grafos de citações e recomendações de artigos352- Use para encontrar artigos altamente influentes353354### Bancos de Dados Biomédicos Especializados355356Use competências apropriadas:357- **ChEMBL**: Competência `bioservices` para bioatividade química358- **UniProt**: Competência `gget` ou `bioservices` para informações de proteínas359- **KEGG**: Competência `bioservices` para vias e genes360- **COSMIC**: Competência `gget` para mutações em câncer361- **AlphaFold**: `gget alphafold` para estruturas de proteínas362- **PDB**: `gget` ou API direta para estruturas experimentais363364### Encadeamento de Citações365366Expanda busca via redes de citações:3673681. **Citações diretas** (artigos que citam artigos principais):369 - Use Google Scholar "Citado por"370 - Use APIs Semantic Scholar ou OpenAlex371 - Identifica pesquisa mais nova construindo sobre trabalho seminal3723732. **Citações reversas** (referências de artigos principais):374 - Extraia referências de artigos incluídos375 - Identifique trabalho fundacional altamente citado376 - Encontre artigos citados por múltiplos estudos incluídos377378## Guia de Estilo de Citação379380Orientação detalhada de formatação está em `references/citation_styles.md`. Referência rápida:381382### APA (7ª Edição)383- No texto: (Smith et al., 2023)384- Referência: Smith, J. D., Johnson, M. L., & Williams, K. R. (2023). Título. *Periódico*, *22*(4), 301-318. https://doi.org/10.xxx/yyy385386### Nature387- No texto: Números sobrescritos^1,2^388- Referência: Smith, J. D., Johnson, M. L. & Williams, K. R. Título. *Nat. Rev. Drug Discov.* **22**, 301-318 (2023).389390### Vancouver391- No texto: Números sobrescritos^1,2^392- Referência: Smith JD, Johnson ML, Williams KR. Título. Nat Rev Drug Discov. 2023;22(4):301-18.393394**Sempre verifique citações** com verify_citations.py antes de finalizar.395396## Melhores Práticas397398### Estratégia de Busca3991. **Use múltiplos bancos de dados** (mínimo 3): Garante cobertura abrangente4002. **Inclua servidores de preprints**: Captura achados mais recentes não publicados4013. **Documente tudo**: Strings de busca, datas, contagens de resultados para reprodutibilidade4024. **Teste e refine**: Execute buscas piloto, revise resultados, ajuste termos403404### Triagem e Seleção4051. **Use critérios claros**: Documente critérios de inclusão/exclusão antes da triagem4062. **Triagem sistemática**: Título → Resumo → Texto completo4073. **Documente exclusões**: Registre razões para excluir estudos4084. **Considere triagem dupla**: Para revisões sistemáticas, dois revisores triagem independentemente409410### Síntese4111. **Organize tematicamente**: Agrupe por temas, NÃO por estudos individuais4122. **Sintetize entre estudos**: Compare, contraste, identifique padrões4133. **Seja crítico**: Avalie qualidade e consistência de evidência4144. **Identifique lacunas**: Observe o que está faltando ou pouco estudado415416### Qualidade e Reprodutibilidade4171. **Avalie qualidade do estudo**: Use ferramentas apropriadas de avaliação de qualidade4182. **Verifique todas as citações**: Execute script verify_citations.py4193. **Documente metodologia**: Forneça detalhe suficiente para outros reproduzirem4204. **Siga diretrizes**: Use PRISMA para revisões sistemáticas421422### Escrita4231. **Seja objetivo**: Apresente evidência justamente, reconheça limitações4242. **Seja sistemático**: Siga template estruturado4253. **Seja específico**: Inclua números, estatísticas, tamanhos de efeito quando disponível4264. **Seja claro**: Use headings claros, fluxo lógico, organização temática427428## Armadilhas Comuns a Evitar4294301. **Busca em banco de dados único**: Perde artigos relevantes; sempre busque em múltiplos4312. **Sem documentação de busca**: Torna revisão irreproduível; documente todas as buscas4323. **Sumário estudo-por-estudo**: Falta síntese; organize tematicamente em vez disso4334. **Citações não verificadas**: Leva a erros; sempre execute verify_citations.py4345. **Busca muito ampla**: Produz milhares de resultados irrelevantes; refine com termos específicos4356. **Busca muito restrita**: Perde artigos relevantes; inclua sinônimos e termos relacionados4367. **Ignora preprints**: Perde achados mais recentes; inclua bioRxiv, medRxiv, arXiv4378. **Sem avaliação de qualidade**: Trata toda evidência igualmente; avalie e reporte qualidade4389. **Viés de publicação**: Apenas resultados positivos publicados; observe viés potencial43910. **Busca desatualizada**: Campo evolui rapidamente; declare claramente data da busca440441## Exemplo de Fluxo de Trabalho442443Fluxo de trabalho completo para análise de literatura biomédica:444445```bash446# 1. Crie documento de revisão a partir do template447cp assets/review_template.md analise_crispr_celula_falciforme.md448449# 2. Busque em múltiplos bancos de dados usando competências apropriadas450# - Use competência gget para PubMed, bioRxiv451# - Use acesso API direto para arXiv, Semantic Scholar452# - Exporte resultados em formato JSON453454# 3. Agregue e processe resultados455python scripts/search_databases.py combined_results.json \456 --deduplicate \457 --rank citations \458 --year-start 2015 \459 --year-end 2024 \460 --format markdown \461 --output search_results.md \462 --summary463464# 4. Triagem de resultados e extração de dados465# - Triagem manual de títulos, resumos, textos completos466# - Extração de dados principais para o documento de revisão467# - Organização por temas468469# 5. Escreva a revisão seguindo estrutura do template470# - Introdução com objetivos claros471# - Seção de metodologia detalhada472# - Resultados organizados tematicamente473# - Discussão crítica474# - Conclusões claras475476# 6. Verifique todas as citações477python scripts/verify_citations.py analise_crispr_celula_falciforme.md478479# Revise o relatório de citações480cat analise_crispr_celula_falciforme_citation_report.json481482# Corrija citações que falharam e re-verifique483python scripts/verify_citations.py analise_crispr_celula_falciforme.md484485# 7. Gere PDF profissional486python scripts/generate_pdf.py analise_crispr_celula_falciforme.md \487 --citation-style nature \488 --output analise_crispr_celula_falciforme.pdf489490# 8. Revise saídas finais de markdown e PDF491```492493## Integração com Outras Competências494495Esta competência trabalha de forma integrada com outras competências científicas:496497### Competências de Acesso a Bancos de Dados498- **gget**: PubMed, bioRxiv, COSMIC, AlphaFold, Ensembl, UniProt499- **bioservices**: ChEMBL, KEGG, Reactome, UniProt, PubChem500- **datacommons-client**: Dados demográficos, econômicos, estatísticas de saúde501502### Competências de Análise503- **pydeseq2**: RNA-seq expressão diferencial (para seções de métodos)504- **scanpy**: Análise single-cell (para seções de métodos)505- **anndata**: Dados single-cell (para seções de métodos)506- **biopython**: Análise de sequências (para seções de fundo)507508### Competências de Visualização509- **matplotlib**: Gere figuras e gráficos para revisão510- **seaborn**: Visualizações estatísticas511512### Competências de Escrita513- **brand-guidelines**: Aplique branding institucional ao PDF514- **internal-comms**: Adapte revisão para diferentes audiências515516## Recursos517518### Recursos Inclusos519520**Scripts:**521- `scripts/verify_citations.py`: Verifique DOIs e gere citações formatadas522- `scripts/generate_pdf.py`: Converta markdown em PDF profissional523- `scripts/search_databases.py`: Processe, deduplicar e formate resultados de busca524525**Referências:**526- `references/citation_styles.md`: Guia detalhado de formatação de citações (APA, Nature, Vancouver, Chicago, IEEE)527- `references/database_strategies.md`: Estratégias abrangentes de busca em banco de dados528529**Assets:**530- `assets/review_template.md`: Template de análise de literatura completo com todas as seções531532### Recursos Externos533534**Diretrizes:**535- PRISMA (Revisões Sistemáticas): http://www.prisma-statement.org/536- Manual Cochrane: https://training.cochrane.org/handbook537- AMSTAR 2 (Qualidade de Revisão): https://amstar.ca/538539**Ferramentas:**540- Navegador MeSH: https://meshb.nlm.nih.gov/search541- PubMed Advanced Search: https://pubmed.ncbi.nlm.nih.gov/advanced/542- Guia Boolean Search: https://www.ncbi.nlm.nih.gov/books/NBK3827/543544**Estilos de Citação:**545- APA Style: https://apastyle.apa.org/546- Nature Portfolio: https://www.nature.com/nature-portfolio/editorial-policies/reporting-standards547- NLM/Vancouver: https://www.nlm.nih.gov/bsd/uniform_requirements.html548549## Dependências550551### Pacotes Python Obrigatórios552```bash553pip install requests # Para verificação de citações554```555556### Ferramentas de Sistema Obrigatórias557```bash558# Para geração de PDF559brew install pandoc # macOS560apt-get install pandoc # Linux561562# Para LaTeX (geração PDF)563brew install --cask mactex # macOS564apt-get install texlive-xetex # Linux565```566567Verifique dependências:568```bash569python scripts/generate_pdf.py --check-deps570```571572## Resumo573574Esta competência de análise de literatura fornece:5755761. **Metodologia sistemática** seguindo melhores práticas acadêmicas5772. **Integração multi-banco de dados** via competências científicas existentes5783. **Verificação de citações** garantindo acurácia e credibilidade5794. **Saída profissional** em formatos markdown e PDF5805. **Orientação abrangente** cobrindo todo processo de revisão5816. **Garantia de qualidade** com ferramentas de verificação e validação5827. **Reprodutibilidade** através de requisitos de documentação detalhada583584Conduza análises de literatura rigorosas e minuciosas que atendam padrões acadêmicos e forneçam síntese abrangente do conhecimento atual em qualquer domínio.