sandeco Skill: Extrator de Contexto (Mira)
Objetivo
Transformar uma fonte bruta (projeto de código, PDF, capítulo LaTeX, texto) em um briefing.md estruturado para o /mira-planner. É o que permite ao Mira morar numa pasta isolada e ainda apresentar qualquer projeto.
Regra de ouro
Leia das fontes, escreva apenas em decks/. Nunca crie, edite ou apague arquivos dentro da pasta de uma fonte vinculada.
Fluxo de Execução
Passo 1: Resolver a fonte
- Leia
mira.config.jsonna raiz da instalação. - Se o usuário citou a fonte pelo nome ("slides sobre o reversa"), localize-a em
sources[]. - Se não há fonte correspondente, pergunte se deve vincular (
npx mira link <caminho>) ou aceite um caminho direto. - Verifique se o caminho existe. Se não, avise e pare.
Passo 2: Extrair conforme o tipo
type: projeto (pasta de código)
- Leia README.md, docs/, package.json (ou equivalente) para entender propósito e arquitetura.
- Mapeie a estrutura de pastas (2 níveis) e identifique os módulos principais.
- Liste comandos/CLI, agentes, features — o que o projeto FAZ.
- Capture 2-3 trechos de código emblemáticos (curtos) que merecem slide.
type: pdf
- Extraia o texto (use a skill /pdf se necessário).
- Identifique título, seções, conceitos-chave, dados numéricos e figuras descritas.
type: latex
- Leia o .tex, ignore preâmbulo, mapeie \chapter/\section, extraia conceitos, código e tabelas.
type: texto
- Leia diretamente e estruture por temas.
Passo 3: Gerar o briefing
Escreva decks/<nome-do-deck>/briefing.md com:
# Briefing: [nome]
**Fonte:** [name] ([type]) — [path]
**Data da extração:** [data]
## Essência em uma frase
[o que é, para quem, por quê]
## Conceitos-chave (candidatos a slide)
1. [conceito] — [por que importa] — [sugestão visual: d3-fluxo|comparacao|metricas|timeline|codigo]
2. ...
## Dados e números
[métricas, versões, benchmarks — material para card_metricas]
## Trechos de código emblemáticos
[se houver]
## Narrativa sugerida
[arco: problema → solução → como funciona → resultados → CTA]
## Lacunas
[o que não foi encontrado na fonte e talvez o usuário precise fornecer]
Passo 4: Encadear
Apresente um resumo do briefing ao usuário e pergunte se pode acionar o /mira-planner com esse material.