¿Qué hace Registros de Trabajo en Jira?
Se aplica solo cuando tracker_backend: jira en $JOB_SEARCH_HOME/integrations.yaml. Si el backend es trello, usa la skill trello-card-rules en su lugar.
Identifica el sitio, proyecto e IDs de campo de integrations.yaml bajo jira.*. Nunca codifiques una URL de sitio, clave de proyecto, ID de campo, dirección de correo electrónico o token — ni de memoria, ni de una copia anterior de esta skill, y nunca imprimas una credencial.
Campos a establecer al crear un registro
| Campo | Valor |
|---|---|
| Resumen | <Título del Rol> — <Empresa> |
| Fecha de inicio | la fecha en que se crea el registro |
| Fuente | de dónde vino la oportunidad, ej. seek o linkedin |
| Prioridad | establecida según el resultado del filtrado |
| Descripción | el enlace del trabajo como hipervínculo en la primera línea, luego la descripción completa del trabajo |
Carril. Crea el registro en el carril Backlog. Nunca crees directamente en Pendiente: la promoción a Pendiente es una decisión de triaje para el candidato, no el paso de ingreso.
Resumen. Usa <Título del Rol> — <Empresa> sin prefijo. Un prefijo como Búsqueda de Trabajo: no añade nada: cada registro en el proyecto es un registro de trabajo, y el prefijo solo ensancha el título y rompe las búsquedas basadas en título.
Fecha de inicio. Establécelo en el día en que se crea el registro, para que la fecha en que la oportunidad entró en el pipeline quede registrada en lugar de inferirse del historial del ticket. Esta es la fecha de inicio del registro, no la fecha de inicio del rol. El ID del campo proviene de jira.fields.start_date.
Fuente. Registra de dónde vino la oportunidad en el campo Fuente, cuyo ID es jira.fields.source. Los valores aceptados provienen de jira.source_values: seek, linkedin, recruiter, referral, company-site, o direct. Nunca lo dejes en blanco — un registro sin fuente no puede filtrarse por canal más tarde, que es el objetivo del campo.
Ten en cuenta que en un proyecto gestionado por equipo (next-gen) un campo personalizado tiene ámbito de proyecto y puede no aparecer en la API de metadatos de creación. Lee el ID de la salida expand=names del issue, o de /rest/api/3/field, en lugar de concluir que el campo no existe.
Conteo de empleados. Donde el proyecto rastrea el tamaño de la empresa, registra el número de empleados con su fuente y fecha de referencia, por ejemplo ~3,090 (Informe anual junio 2026) o 501-1,000 (Banda de LinkedIn). Un número sin fuente es peor que ningún número.
El enlace del trabajo
Mantén el enlace a la publicación original al inicio de la descripción, como un hipervínculo con texto legible, para que sea lo primero visible al abrir el registro. Nunca lo entierres entre otros metadatos, y nunca dejes una URL desnuda en medio del párrafo.
Fórmate como la primera línea de la descripción:
[<Título del Rol> — <Empresa>](<url de la publicación>)
Si el proyecto tiene un campo dedicado de URL o enlace, establécelo también — pero el enlace en la descripción es el que siempre debe estar presente, porque sobrevive a los cambios de configuración de campo y se exporta con la descripción.
Establece la etiqueta de fuente (seek, linkedin) en el mismo paso, para que el registro pueda filtrarse por canal más tarde.
Verificación de duplicados — haz esto antes de crear cualquier cosa
Busca en el proyecto la empresa y el título del rol antes de escribir:
project = <key> AND summary ~ "<empresa>"
project = <key> AND summary ~ "<palabras clave del título del rol>"
Dos modos de fallo se repiten:
- Mayúsculas/minúsculas y puntuación.
Senior DevOps Engineer - AWSySenior DevOps Engineer — AWSson el mismo rol. Normaliza mayúsculas, espacios y guiones antes de comparar. - Confianza solo en el título. Un título es una pista de filtrado, nunca prueba de nivel o ajuste. No abras un registro solo por la solidez del título.
Si ya existe un registro, actualízalo en lugar de crear un segundo.
Formato de la descripción
La descripción lleva la descripción del trabajo y el resultado del filtrado. Manténlo legible de una sola pasada:
- Encabezados
##con contenido debajo; nunca dos encabezados seguidos - Valores clave como etiquetas en negrita (
**Rol:**,**Ubicación:**), no una lista con viñetas de dos puntos - Línea en blanco entre secciones
- Enlaces como
[texto descriptivo](url), nunca un "Ver: url" desnudo - Código, nombres de archivo y comandos entre acentos graves
- Sin párrafos de pared de texto; divídelos
- Sin listas numeradas anidadas
Copia la descripción completa del trabajo hasta su párrafo final. Una descripción truncada es un registro incompleto.
Adjuntos
- Almacena tanto el código fuente HTML como el PDF renderizado.
- El nombre del archivo PDF debe coincidir con el nombre del archivo HTML, por ejemplo
cv_<KEY>_<slug-empresa>.pdfjunto concv_<KEY>_<slug-empresa>.html. - Sube el reemplazo primero, verifica que llegó con el nombre y tamaño esperados, luego elimina la copia reemplazada. No dejes dos versiones adjuntas.
Los veredictos deben seguir a las razones
Un veredicto solo es útil si las razones indicadas lo respaldan. Antes de escribir uno:
- Una razón positiva (un empleador estable, un dominio familiar, stack superpuesto) nunca puede respaldar un veredicto de
DepriorizaroLead-muerto. Si cada razón enumerada es positiva, entonces o el veredicto es incorrecto o la razón real falta. - Indica el motivo real: desajuste de stack o disciplina, ubicación, salario por debajo del mínimo, o una regla de exclusión nombrada. Un veredicto sin motivo indicado es un marcador de posición, no una evaluación.
- Nunca heredes un veredicto de un criterio que desde entonces ha cambiado. Si la objeción original ya no se aplica, el veredicto debe re-derivarse, no dejarse en pie.
Revalidar cuando los criterios cambien
Los registros se escriben una vez y luego se degradan. Cuando preferences.yaml cambie (niveles de título, salario mínimo, stacks excluidos) o profile.md adquiera un hecho material nuevo:
- Relee la justificación de ajuste y las brechas de cada registro en los carriles activos: Pendiente, Aplicado, Entrevista y Backlog.
- Marca cualquier registro que cite un criterio que ya no se aplique, por ejemplo una objeción de nivel después de que ese nivel se volviera aceptable, o que afirme una habilidad que el perfil no contiene.
- Corrige el razonamiento. No elimines simplemente la objeción obsoleta: eliminarla puede dejar el veredicto sin respaldo, lo que es peor que el error original.
- Deja los Leads-muertos en paz. Están inertes.
- Pregunta antes de eliminar. Si una nota o afirmación del CV parece no verificada, confírmala con el candidato en lugar de eliminarla. Un resumen de perfil omite experiencia real, por lo que su ausencia no es evidencia de que la afirmación sea falsa. Registra los hechos confirmados de vuelta en el perfil.
Skills relacionadas
job-search-quality— filtrado, criterios de salario y título, y la puerta de evidencia que determina si un registro está completocv-attach-workflow— generar el CV personalizado y adjuntarlojira-job-recordses la contraparte de Jira detrello-card-rules