Communitygithub.com

Registros de Vagas no Jira

Como registrar uma oportunidade de emprego como um issue do Jira — formato do resumo, campos obrigatórios, verificação de duplicatas, formatação da descrição e anexos. Aplica-se quando tracker_backend é jira. Use quando uma vaga se torna um registro no tracker, e ao criar ou atualizar registros de vagas em um board do Jira.

O que é Registros de Vagas no Jira?

Esta skill define as regras para criar e gerenciar registros de vagas de emprego no Jira, quando o backend configurado é 'jira'. Ela padroniza a criação de issues como registros de oportunidades, desde a verificação de duplicatas até a formatação da descrição e anexos. Principais pontos incluem: usar o formato '<Título do Cargo> — <Empresa>' como resumo, sempre definir a fonte da oportunidade (ex: seek, linkedin), e manter o link da vaga na primeira linha da descrição. A skill também cobre práticas como evitar hardcoding de credenciais, lidar com campos personalizados em projetos team-managed, e revalidar registros quando critérios mudam (preferences.yaml, profile.md). Por fim, garante que vereditos sejam justificados com razões coerentes e nunca herdados de critérios obsoletos. Indicada para usuários que gerenciam pipeline de candidaturas via Jira e precisam de consistência operacional.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SongGithub/personal-skills/tree/HEAD/job-search/skills/jira-job-records

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

CampoValor
Resumo<Título do Cargo> — <Empresa>
Data de inícioa data em que o registro é criado
Fontede onde veio a oportunidade, ex. seek ou linkedin
Prioridadedefinida a partir do resultado da triagem
Descriçãoo 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:

  1. Maiúsculas/minúsculas e pontuação. Senior DevOps Engineer - AWS e Senior DevOps Engineer — AWS são o mesmo cargo. Normalize maiúsculas, espaçamento e travessões antes de comparar.
  2. 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>.pdf junto com cv_<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 Depriorizar ou Lead 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á completo
  • cv-attach-workflow — gerar o CV personalizado e anexá-lo
  • jira-job-records é a contraparte no Jira de trello-card-rules

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

SongGithub/personal-skills

Applies a direct, plain-spoken, Australian-English communication style to any text drafted — chat replies, emails, Slack/Teams messages, tickets, PR and commit descriptions, docs. Use whenever drafting prose, not just visual or code artifacts. Skip when the user explicitly asks for a different tone or voice.

SongGithub/personal-skills

A reusable HTML document design system for CVs, one-pagers and short reports — design tokens, layout, typography, print-to-PDF rules and accessibility. Use when generating or restyling a self-contained HTML document meant to be read on screen or printed to PDF.

SongGithub/personal-skills

End-to-end job application workflow. Screen a posting, tailor the HTML CV from the master template, print it to PDF, archive the artifact, and file the result against the configured tracker. Triggers on apply, apply to jobs, submit application, tailor and send CV.

SongGithub/personal-skills

CV attach workflow. Generate a tailored HTML CV for a tracked role, attach the rendered artifact back to its tracker item, then verify the attachment actually landed. Covers template selection, tailoring order, upload headers, and read-back verification.

SongGithub/personal-skills

First-principles reasoning for a startup or a job search, in the spirit of Elon Musk's "zero restart" framing: survival cashflow, the idiot index, and the physical first step. 第一性原理创业与求职法 — 从马斯克「归零重启」思维出发,用生存现金流、白痴指数、长期物理第一步三个步骤,指导创业和求职

SongGithub/personal-skills

Assistant for job applications: evaluating job postings, tailoring CVs, writing cover letters, and preparing for interviews. Triggers on keywords like: job posting, job application, CV, cover letter, resume, interview prep, job fit, career, application, apply, SEEK

SongGithub/personal-skills

Job scraper. Searches job boards for new positions matching the candidate profile, deduplicates against previously seen jobs and the tracker file, then presents new matches with a quick fit assessment. Triggers on: job scrape, find jobs, search jobs, new jobs, /scrape.

SongGithub/personal-skills

Screen job opportunities, prepare job records and tailored CVs, and verify the result against current salary, title, source, and document-quality preferences. Applies to job boards and scheduled searches.

SongGithub/personal-skills

Trello card rules for the job-search tracker. Enforces case-insensitive and fuzzy duplicate detection before any card is created, title formatting, lane placement from config, and logging each card to the tracker database. Applies whenever a job posting becomes a card.

SongGithub/personal-skills

Compares tracked job postings against the candidate profile to find skill gaps, then builds a prioritised gap heatmap and a learning plan with searched study resources and a study order. Triggers on: upskill, skill gaps, what should I learn, learning plan, upskill report.

Habilidades Relacionadas