Minerador de Ideias

Skill Idea Miner

Extraia automaticamente candidatos a ideias de habilidades dos logs de sessão do Claude Code, avalie-os quanto à novidade, viabilidade e valor comercial, e mantenha um backlog priorizado para a geração downstream de habilidades.

Quando Usar

• Execução automatizada do pipeline semanal (Sábado 06:00 via launchd)
• Atualização manual do backlog: python3 scripts/run_skill_generation_pipeline.py --mode weekly
• Dry-run para pré-visualizar candidatos sem pontuação via LLM

Pré-requisitos

• Python 3.10+ com o pacote pyyaml
• Claude CLI instalado e autenticado (claude --version para verificar)
• Logs de sessão em ~/.claude/projects/<project>/ (criados automaticamente pelo Claude Code)
• Nenhuma chave de API necessária (usa Claude CLI para chamadas LLM)

Fluxo de Trabalho

Início Rápido

# Dry-run: pré-visualiza candidatos minerados sem pontuação via LLM
python3 scripts/mine_session_logs.py --dry-run --output-dir reports/

# Mineração completa com pontuação (requer Claude CLI)
python3 scripts/mine_session_logs.py --output-dir reports/

# Pontuar candidatos existentes
python3 scripts/score_ideas.py \
  --candidates reports/raw_candidates.yaml \
  --output-dir logs/

Estágio 1: Mineração de Logs de Sessão

1. Enumerar logs de sessão de projetos na lista de permissões em ~/.claude/projects/
2. Filtrar pelos últimos 7 dias usando mtime do arquivo, confirmar com o campo timestamp
3. Extrair mensagens do usuário (type: "user", userType: "external")
4. Extrair padrões de uso de ferramentas das mensagens do assistente
5. Executar detecção determinística de sinais:
   • Frequência de uso de habilidades (referências ao caminho skills/*/)
   • Padrões de erro (códigos de saída diferentes de zero, flags is_error, palavras-chave de exceção)
   • Sequências repetitivas de ferramentas (3+ ferramentas repetidas 3+ vezes)
   • Palavras-chave de solicitação de automação (Inglês e Japonês)
   • Solicitações não resolvidas (intervalo de 5+ minutos após mensagem do usuário)
6. Invocar Claude CLI headless para abstração de ideias
7. Gerar raw_candidates.yaml

Estágio 2: Pontuação e Deduplicação

1. Carregar habilidades existentes do frontmatter de skills/*/SKILL.md
2. Deduplicar via similaridade de Jaccard (limiar > 0.5) contra:
   • Nomes e descrições de habilidades existentes
   • Ideias existentes no backlog
3. Pontuar candidatos não duplicados com Claude CLI:
   • Novidade (0-100): diferenciação das habilidades existentes
   • Viabilidade (0-100): implementabilidade técnica
   • Valor comercial (0-100): valor prático para investidores/negociadores
   • Composto = 0.3 * Novidade + 0.3 * Viabilidade + 0.4 * Valor Comercial
4. Mesclar candidatos pontuados em logs/.skill_generation_backlog.yaml

Formato de Saída

raw_candidates.yaml

generated_at_utc: "2026-03-08T06:00:00Z"
period: {from: "2026-03-01", to: "2026-03-07"}
projects_scanned: ["claude-trading-skills"]
sessions_scanned: 12
candidates:
  - id: "raw_2026w10_001"
    title: "Parser de Imagens de Earnings Whispers"
    source_project: "claude-trading-skills"
    evidence:
      user_requests: ["Extrair datas de lucros de captura de tela"]
      pain_points: ["Leitura manual de imagens"]
      frequency: 3
    raw_description: "Parsear capturas de tela do Earnings Whispers para extrair datas."
    category: "extracao-de-dados"

Backlog (logs/.skill_generation_backlog.yaml)

updated_at_utc: "2026-03-08T06:15:00Z"
ideas:
  - id: "idea_2026w10_001"
    title: "Parser de Imagens de Earnings Whispers"
    description: "Habilidade que parseia capturas de tela do Earnings Whispers..."
    category: "extracao-de-dados"
    scores: {novelty: 75, feasibility: 60, trading_value: 80, composite: 73}
    status: "pending"

Recursos

• references/idea_extraction_rubric.md — Critérios de detecção de sinais e rubrica de pontuação
• scripts/mine_session_logs.py — Analisador de logs de sessão
• scripts/score_ideas.py — Pontuador e deduplicador