Habilidade de Pesquisa Profunda no GitHub
Pesquisa multi-estágio combinando API do GitHub, web_search e web_fetch para produzir relatórios abrangentes em markdown.
Fluxo de Trabalho da Pesquisa
- Rodada 1: API do GitHub
- Rodada 2: Descoberta
- Rodada 3: Investigação Aprofundada
- Rodada 4: Mergulho Profundo
Metodologia Central
Estratégia de Consulta
Do Geral para o Específico: Comece com a API do GitHub, depois consultas genéricas, refine com base nas descobertas.
Rodada 1: API do GitHub
Rodada 2: "{tópico} visão geral"
Rodada 3: "{tópico} arquitetura", "{tópico} vs alternativas"
Rodada 4: "{tópico} issues", "{tópico} roadmap", "site:github.com {tópico}"
Priorização de Fontes:
- Documentação/repositórios oficiais (maior peso)
- Blogs técnicos (Medium, Dev.to)
- Artigos de notícias (veículos verificados)
- Discussões da comunidade (Reddit, HN)
- Redes sociais (menor peso, para sentimento)
Rodadas de Pesquisa
Rodada 1 - API do GitHub
Execute diretamente scripts/github_api.py sem usar read_file():
python /caminho/para/skill/scripts/github_api.py <proprietário> <repositório> summary
python /caminho/para/skill/scripts/github_api.py <proprietário> <repositório> readme
python /caminho/para/skill/scripts/github_api.py <proprietário> <repositório> tree
Comandos disponíveis (o último argumento de github_api.py):
- summary
- info
- readme
- tree
- languages
- contributors
- commits
- issues
- prs
- releases
Rodada 2 - Descoberta (3-5 web_search)
- Obter visão geral e identificar termos-chave
- Encontrar site/documentação oficial
- Identificar principais players/concorrentes
Rodada 3 - Investigação Aprofundada (5-10 web_search + web_fetch)
- Detalhes da arquitetura técnica
- Linha do tempo de eventos importantes
- Sentimento da comunidade
- Use web_fetch em URLs valiosas para obter conteúdo completo
Rodada 4 - Mergulho Profundo
- Analisar histórico de commits para linha do tempo
- Revisar issues/PRs para evolução de funcionalidades
- Verificar atividade de contribuidores
Estrutura do Relatório
Siga o template em assets/report_template.md:
- Bloco de Metadados - Data, nível de confiança, assunto
- Resumo Executivo - Visão geral de 2 a 3 frases com métricas principais
- Linha do Tempo Cronológica - Divisão em fases com datas
- Seções Principais de Análise - Mergulhos profundos específicos do tópico
- Métricas e Comparações - Tabelas, gráficos de crescimento
- Pontos Fortes e Fracos - Avaliação equilibrada
- Fontes - Referências categorizadas
- Avaliação de Confiança - Alegações por nível de confiança
- Metodologia - Abordagem de pesquisa utilizada
Diagramas Mermaid
Inclua diagramas quando forem úteis:
Linha do Tempo (Gantt):
gantt
title Linha do Tempo do Projeto
dateFormat YYYY-MM-DD
section Fase 1
Desenvolvimento :2025-01-01, 2025-03-01
section Fase 2
Lançamento :2025-03-01, 2025-04-01
Arquitetura (Fluxograma):
flowchart TD
A[Usuário] --> B[Coordenador]
B --> C[Planejador]
C --> D[Equipe de Pesquisa]
D --> E[Relator]
Comparação (Pizza/Barras):
pie title Participação de Mercado
"Projeto A" : 45
"Projeto B" : 30
"Outros" : 25
Pontuação de Confiança
Atribua confiança com base na qualidade da fonte:
| Confiança | Critérios |
|---|---|
| Alta (90%+) | Documentação oficial, dados do GitHub, múltiplas fontes corroborantes |
| Média (70-89%) | Fonte única confiável, artigos recentes |
| Baixa (50-69%) | Redes sociais, alegações não verificadas, informações desatualizadas |
Saída
Salve o relatório como: research_{tópico}_{AAAAMMDD}.md
Regras de Formatação
- Conteúdo em português: Use pontuação padrão (.,:;!?)
- Termos técnicos: Forneça URL da Wiki/doc na primeira menção
- Tabelas: Use para métricas e comparações
- Blocos de código: Para exemplos técnicos
- Mermaid: Para arquitetura, linhas do tempo, fluxos
Melhores Práticas
- Comece com fontes oficiais - Repositório, docs, blog da empresa
- Verifique datas em commits/PRs - Mais confiáveis que artigos
- Triangulação de alegações - 2+ fontes independentes
- Anote informações conflitantes - Não esconda contradições
- Distinga fato de opinião - Rotule especulações claramente
- CRÍTICO: Sempre inclua citações inline - Use o formato
[citation:Título](https://raw.githubusercontent.com/bytedance/deer-flow/main/URL)imediatamente após cada alegação de fontes externas - Extraia URLs dos resultados de busca - web_search retorna {title, url, snippet} - sempre use o campo URL
- Atualize conforme avança - Não espere até o final para sintetizar
Exemplos de Citação
Bom - Com citações inline:
O projeto ganhou 10.000 estrelas em 3 meses após o lançamento [citation:Estatísticas do GitHub](https://github.com/proprietário/repo).
A arquitetura usa LangGraph para orquestração de fluxo de trabalho [citation:Documentação LangGraph](https://langchain.com/langgraph).
Ruim - Sem citações:
O projeto ganhou 10.000 estrelas em 3 meses após o lançamento.
A arquitetura usa LangGraph para orquestração de fluxo de trabalho.