O que Upskill faz?
Analisa vagas de emprego monitoradas em relação ao perfil atual do candidato para encontrar lacunas de habilidades, gerando um mapa de calor de lacunas e um plano de estudos com recursos de aprendizado concretos, pesquisados, e uma ordem de estudo.
Configuração
- Perfil do candidato:
$JOB_SEARCH_HOME/profile.md - Vagas monitoradas:
tracker_pathde$JOB_SEARCH_HOME/integrations.yaml - Os relatórios são salvos em
$JOB_SEARCH_HOME/upskill/
Invocação
/upskill— modo agregado: todas as linhas do arquivo de rastreamento/upskill <URL>— modo direcionado: uma vaga, obtida a partir da URL
Passo 1 — Detectar modo
Sem argumento → agregado. Uma URL → direcionado; mantenha a URL para o Passo 2.
No modo direcionado, derive um slug de relatório a partir do cargo e da empresa, ex.
<slug-da-empresa>-<slug-do-cargo>.
Passo 2 — Carregar dados
Agregado
- Leia o arquivo de rastreamento. Colunas:
data, empresa, setor, cargo, tipo_cargo, canal, status, contato, avaliacao_adequacao, notas, arquivo_cv, arquivo_carta_apresentacao, origem - Anote
cargo,empresa,avaliacao_adequacaopor linha.avaliacao_adequacaoé 0–100; use-a para ponderar lacunas, pois uma baixa avaliação significa que a vaga expôs mais lacunas. - Leia
$JOB_SEARCH_HOME/profile.mdpara obter as habilidades atuais. - Verifique em
$JOB_SEARCH_HOME/upskill/o relatório mais recenterelatorio-YYYY-MM-DD.md; se houver um, carregue-o para a diffs do Passo 8.
Direcionado
- Busque a vaga na web (WebFetch).
- Extraia título, empresa, habilidades obrigatórias, habilidades desejáveis, responsabilidades, contexto do domínio.
- Leia
$JOB_SEARCH_HOME/profile.md. - Nenhum dado do rastreador é usado.
Passo 3 — Passo 1: diff de habilidades técnicas
Agregado. Você não tem as descrições completas das vagas, portanto infira os requisitos prováveis a partir de
cargo, setor e notas. Se origem tiver uma URL ativa, você pode buscá-la; pule URLs mortas ou ausentes.
Construa um mapa de frequência de habilidades e pondere pela adequação: cada vaga contribui
(100 - avaliacao_adequacao) / 100 por ocorrência. A pontuação final é a soma de
peso_adequacao × ocorrencia entre todas as vagas.
Direcionado. Considere as habilidades obrigatórias e desejáveis explícitas. Peso igual. Obrigatórias antes de Desejáveis, em ordem alfabética dentro de cada grupo.
Comparar com o perfil. Remova tudo que já está presente em profile.md, de forma generosa — se o
perfil mencionar uma habilidade de qualquer forma, não é uma lacuna. O que resta é a lista de lacunas de habilidades técnicas:
ordenada por pontuação no modo agregado, obrigatórias-antes-desejáveis e depois alfabética no modo direcionado.
Passo 4 — Passo 2: síntese
Raciocine sobre lacunas que a diffs não capturaria:
- Conhecimento de domínio — setor ou espaço de problema desconhecido
- Habilidades interpessoais — modos de trabalho, comunicação, liderança que o perfil não aborda
- Ferramentas e processos — frameworks, serviços em nuvem, metodologias que aparecem em várias vagas
- Credenciais — uma certificação que várias vagas listam como desejável
Marque cada uma com [dominio], [soft], [ferramentas] ou [credencial]. Não repita lacunas do Passo 1.
Passo 5 — Mapa de calor de lacunas
Combine ambas as passagens em uma tabela priorizada:
- Crítico — habilidades técnicas com alta ponderação, ou uma lacuna de domínio na maioria das vagas
- Alto — habilidades técnicas moderadas, ou lacunas consistentes de soft/ferramentas
- Médio — habilidades técnicas de menor frequência, ou lacunas em poucas vagas
- Baixo — menções isoladas
| Prioridade | Habilidade / Área | Tipo | Origem da Lacuna |
|---|---|---|---|
| Crítico | Kubernetes | Técnica | 4/5 vagas, pontuação 3.2 |
| Alto | Conhecimento de domínio em segurança | Domínio | Síntese LLM |
| Médio | AWS (avançado) | Técnica | 2/5 vagas, pontuação 1.1 |
| Baixo | … | … | … |
Imprima esta tabela antes de continuar, para que o usuário veja a partir do que você está trabalhando.
No modo direcionado, priorize a partir da própria linguagem da vaga: obrigatório → Crítico/Alto, desejável → Médio, inferido → Médio/Baixo.
Passo 6 — Plano de estudos
Cubra toda lacuna Crítica e Alta, mais as Médio se houver menos de cinco lacunas no total.
Para cada lacuna:
- Pesquise na web (WebSearch) recursos atuais e bem avaliados. Inclua o ano atual na consulta para que os
resultados não estejam desatualizados. Exemplo de formato:
"melhor curso de <habilidade> <ano> site:reddit.com OR coursera.org" - Escolha 2–3 recursos. Prefira laboratórios práticos a apenas palestras; documentação oficial para lacunas de ferramentas; livros para lacunas de domínio. Dê nome, URL e uma linha sobre por que é adequado.
- Escreva uma direção de estudo adaptada ao que o candidato já sabe. Diga o que pular e por onde começar.
- Estime o tempo para proficiência operacional (
~20h). Erre para cima.
Agrupe sob títulos temáticos em vez de ordem alfabética: Nuvem & Infraestrutura, MLOps, Conhecimento de Domínio, Segurança, Habilidades Interpessoais & Modos de Trabalho, Certificações.
### Nuvem & Infraestrutura
**Kubernetes** `[Técnica]` — ~20h
- [Recurso](url) — laboratórios práticos, mais práticos do que teóricos
- [Documentação oficial](url) — consulta assim que os fundamentos estiverem consolidados
Direção de estudo: conceitos básicos de contêiner já estão cobertos — comece pelo agendamento de Pods, depois
Serviços e Deployments. Domine manifests e `kubectl` antes de tocar no Helm.
Passo 7 — Ordem de estudo sugerida
- Dependências primeiro — se B precisa de A, coloque A primeiro e anote a dependência
- Crítico antes de Alto antes de Médio dentro de um nível
- Vitórias rápidas no início — uma lacuna Médio rápida pode vir primeiro para gerar impulso
- Conhecimento de domínio por último — estude-o junto com um projeto real
| # | Tópico | Tipo | Tempo Est. | Nota |
|---|---|---|---|---|
| 1 | Kubernetes | Técnica | ~20h | Necessário antes do passo 3 |
| 2 | Pipelines CI/CD | Ferramentas | ~10h | |
| 3 | Conhecimento de domínio em segurança | Domínio | ~15h | Junto com um projeto real |
Tempo total estimado: ~45h
Passo 8 — Escrever e salvar o relatório
Ordem: cabeçalho e modo → desde o último relatório (apenas agregado) → mapa de calor de lacunas → plano de estudos → ordem de estudo sugerida.
- Agregado:
$JOB_SEARCH_HOME/upskill/relatorio-YYYY-MM-DD.md - Direcionado:
$JOB_SEARCH_HOME/upskill/relatorio-YYYY-MM-DD-<slug-da-empresa>-<slug-do-cargo>.md— minúsculas, espaços para hífens, remova caracteres especiais
Seção de diffs, apenas agregado: lacunas fechadas são habilidades do mapa de calor anterior agora presentes no perfil; novas lacunas são entradas do mapa de calor atual ausentes no relatório anterior. Omita toda a seção quando não houver relatório anterior.
Confirme o caminho salvo para o usuário.
Regras
- Nunca invente recursos. Cite apenas o que a WebSearch realmente retornou.
- Pesquise com o ano atual em cada consulta de recurso.
- O modo direcionado ignora completamente o arquivo de rastreamento.
- Seja generoso com a correspondência do perfil. Uma habilidade mencionada de qualquer forma não é uma lacuna.
- Imprima o mapa de calor antes do plano de estudos.
- Sem recursos de estudo para lacunas Baixo a menos que solicitado.
- Sempre salve o relatório, mesmo que a saída do terminal pareça suficiente.
- Crie slugs de nomes de empresas a partir da vaga. Não invente ou adivinhe um.