O que Registros de Vagas no Jira faz?
Aplica-se apenas quando tracker_backend: jira em $JOB_SEARCH_HOME/integrations.yaml. Se o
backend for trello, use a skill trello-card-rules.
Identifique o site, projeto e IDs dos campos em integrations.yaml sob jira.*. Nunca
codifique uma URL de site, chave de projeto, ID de campo, endereço de e-mail ou token — nem de memória, nem de
uma cópia antiga desta skill, e nunca imprima uma credencial.
Campos a definir ao criar um registro
| Campo | Valor |
|---|---|
| Resumo | <Título do Cargo> — <Empresa> |
| Data de início | a data em que o registro é criado |
| Fonte | de onde veio a oportunidade, ex. seek ou linkedin |
| Prioridade | definida a partir do resultado da triagem |
| Descrição | o link da vaga como hiperlink na primeira linha, depois a descrição completa da vaga |
Faixa. Crie o registro na faixa Backlog. Nunca crie diretamente em To Do: a promoção para To Do é uma decisão de triagem do candidato, não da etapa de entrada.
Resumo. Use <Título do Cargo> — <Empresa> sem prefixo. Um prefixo como Caça de Emprego: não
acrescenta nada: todo registro no projeto é um registro de vaga, e o prefixo apenas alarga o título e
quebra buscas baseadas em título.
Data de início. Defina-a para o dia em que o registro é criado, para que a data em que a oportunidade entrou no
pipeline seja registrada, em vez de ser inferida do histórico do ticket. Esta é a data de início do registro,
não a data de início da vaga. O ID do campo vem de jira.fields.start_date.
Fonte. Registre de onde veio a oportunidade no campo Fonte, cujo ID é
jira.fields.source. Valores aceitos vêm de jira.source_values: seek, linkedin,
recruiter, referral, company-site ou direct. Nunca deixe em branco — um registro sem
fonte não pode ser filtrado por canal posteriormente, que é exatamente o objetivo do campo.
Observe que em um projeto gerenciado por equipe (next-gen), um campo personalizado tem escopo de projeto e pode não
aparecer na API de metadados de criação. Leia o ID da saída expand=names do issue, ou de
/rest/api/3/field, em vez de concluir que o campo não existe.
Contagem de pessoas. Onde o projeto rastreia o porte da empresa, registre a contagem de funcionários com sua fonte
e data de referência, por exemplo ~3.090 (relatório anual Jun 2026) ou 501-1.000 (faixa do LinkedIn).
Um número sem fonte é pior do que nenhum número.
O link da vaga
Mantenha o link para a publicação original no topo da descrição, como um hiperlink com texto legível, para que seja a primeira coisa visível quando o registro for aberto. Nunca o enterre entre outros metadados, e nunca deixe uma URL solta no meio de um parágrafo.
Formate-o como a primeira linha da descrição:
[<Título do Cargo> — <Empresa>](<url da vaga>)
Se o projeto tiver um campo dedicado de URL ou link, defina-o também — mas o link na descrição é aquele que sempre deve estar presente, porque sobrevive a mudanças de configuração de campo e é exportado com a descrição.
Defina a etiqueta de fonte (seek, linkedin) na mesma etapa, para que o registro possa ser filtrado por
canal posteriormente.
Verificação de duplicatas — faça isso antes de criar qualquer coisa
Pesquise no projeto pela empresa e pelo título do cargo antes de escrever:
project = <chave> AND summary ~ "<empresa>"
project = <chave> AND summary ~ "<palavras-chave do título>"
Dois modos de falha recorrentes:
- Maiúsculas/minúsculas e pontuação.
Senior DevOps Engineer - AWSeSenior DevOps Engineer — AWSsão o mesmo cargo. Normalize maiúsculas, espaçamento e travessões antes de comparar. - Confiança apenas no título. Um título é uma dica de triagem, nunca prova de nível ou adequação. Não abra um registro apenas com base no título.
Se um registro já existir, atualize-o em vez de criar um segundo.
Formatação da descrição
A descrição carrega a descrição da vaga e o resultado da triagem. Mantenha-a legível em uma passada:
- Cabeçalhos
##com conteúdo abaixo; nunca dois cabeçalhos consecutivos - valores-chave como rótulos em negrito (
**Cargo:**,**Localização:**), não uma lista de marcadores com dois-pontos - linha em branco entre seções
- links como
[texto descritivo](url), nunca um "Veja: url" solto - código, nomes de arquivo e comandos entre crases
- sem parágrafos em bloco de texto; quebre-os
- sem listas numeradas aninhadas
Copie a descrição completa da vaga até seu parágrafo final. Uma descrição truncada é um registro incompleto.
Anexos
- Armazene tanto o HTML fonte quanto o PDF renderizado.
- O nome do PDF deve corresponder ao nome do HTML, por exemplo
cv_<CHAVE>_<slug-da-empresa>.pdfjunto comcv_<CHAVE>_<slug-da-empresa>.html. - Faça upload do substituto primeiro, verifique se ele foi registrado com o nome e tamanho esperados, e então exclua a cópia substituída. Não deixe duas versões anexadas.
Verdictos devem decorrer das razões
Um veredito só é útil se as razões declaradas o suportam. Antes de escrever um:
- Uma razão positiva (um empregador estável, um domínio familiar, stack sobreposta) nunca pode suportar
um veredito de
DepriorizarouLead morto. Se toda razão listada for positiva, então ou o veredito está errado ou a razão real está faltando. - Declare o fundamento real: incompatibilidade de stack ou disciplina, localização, salário abaixo do piso, ou uma regra de exclusão nomeada. Um veredito sem fundamento declarado é um espaço reservado, não uma avaliação.
- Nunca herde um veredito de um critério que mudou desde então. Se a objeção original não se aplica mais, o veredito deve ser re-derivado, não mantido.
Re-validar quando critérios mudarem
Registros são escritos uma vez e depois estagnam. Quando preferences.yaml mudar (níveis de título, piso salarial,
stacks excluídos) ou profile.md ganhar um fato material novo:
- Releia a lógica de adequação e lacunas de cada registro nas faixas ativas: To Do, Applied, Interview e Backlog.
- Identifique qualquer registro que cite um critério que não se aplica mais, por exemplo uma objeção de nível após aquele nível ter se tornado aceitável, ou que afirme uma habilidade que o perfil não contém.
- Corrija o raciocínio. Não simplesmente delete a objeção obsoleta: removê-la pode deixar o veredito sem suporte, o que é pior do que o erro original.
- Deixe leads mortos em paz. Eles são inertes.
- Pergunte antes de deletar. Se uma nota ou afirmação no CV parecer não verificada, confirme com o candidato em vez de removê-la. Um resumo de perfil omite experiência real, então ausência lá não é evidência de que a afirmação é falsa. Registre fatos confirmados de volta no perfil.
Skills relacionadas
job-search-quality— triagem, critérios de salário e título, e a porta da evidência que determina se um registro está completocv-attach-workflow— gerar o CV personalizado e anexá-lojira-job-recordsé a contraparte no Jira detrello-card-rules