Manuales de contratación
Una biblioteca solo para el equipo con el material de contratación que reutilizas — documentos y enlaces, marcados para que Kit los muestre al configurar etapas y los agentes de IA puedan leerlos.
Los manuales están en Contratación → Manuales, en /hiring/playbooks. Un manual es un grupo con nombre de recursos: documentos en Markdown escritos dentro de Kit y enlaces a material que vive en otro sitio.
Nada de un manual se muestra nunca a los candidatos. Es de uso interno del equipo: el portal de empleo, el portal del candidato y los correos de candidatura no leen de ahí.
El manual de un equipo de ingeniería podría contener:
| Recurso | Tipo |
|---|---|
| Vídeo de presentación de la empresa | Enlace (YouTube — se reproduce integrado) |
| Cómo hacemos la llamada inicial | Documento |
| Lista de comprobación de revisión de código — backend | Documento |
| Banco de preguntas de encaje cultural | Documento |
| Logística de la jornada presencial (Google Doc) | Enlace |
Quién puede hacer qué
| Leer | Crear, editar, eliminar, reordenar | |
|---|---|---|
| Miembro de Contratación | Sí | No |
| Admin de Contratación | Sí | Sí |
Los niveles son por módulo: un admin de Contratación que solo sea miembro en Outreach conserva aquí el acceso de escritura completo. Consulta Roles del equipo.
Documentos y enlaces
Un documento es Markdown que escribes en Kit. El editor tiene un selector Escribir / Vista previa; se renderizan encabezados, tablas, listas de tareas, tachado y URLs sueltas. El HTML sin procesar se descarta, no se escapa. El contenido tiene un tope de 100 000 caracteres.
Un enlace es una URL a algo que ya guardas en otro sitio. Pulsa Obtener vista previa y los enlaces de YouTube, Vimeo y Loom obtienen un reproductor integrado; el resto se guarda como enlace simple, que es lo habitual con documentos y wikis. No hay subida de archivos: deja el archivo donde ya está y enlázalo.
Warning
El tipo de un recurso queda fijado al guardarlo. Un documento no puede convertirse después en un enlace, ni al revés: cambiarlo dejaría huérfanos el contenido y todas sus versiones. Para cambiar de tipo, crea un recurso nuevo y elimina el antiguo.
Los administradores pueden arrastrar los recursos para ordenarlos en la página del manual. Reordenar se desactiva mientras el filtro esté en uso, porque una lista filtrada es un subconjunto.
Sugerencias al configurar etapas
Al añadir o editar un recurso, marca tipos de etapa en Sugerir al configurar etapas: Enviar solicitud, Ejercicio de código, Entrevista, Oferta, Revisión de portafolio, Cuestionario, Verificación de referencias, Tarea para casa, Evaluación del equipo, Presentación en video, Respuesta en video.
Quien abra una etapa de ese tipo verá entonces un panel De tu manual con los recursos marcados. Cada uno se abre en una pestaña nueva, así que no se pierde nada sin guardar de la etapa.
El panel tiene un botón para ocultarlo, y ocultarlo es deliberadamente limitado:
- Por persona. Ocultarlo nunca lo oculta para nadie más.
- Por tipo de etapa. Ocultarlo en las etapas de Entrevista lo deja visible en las de Ejercicio de código.
- Vuelve con cualquier añadido posterior. Un recurso marcado después de que alguien ocultara el panel se lo devuelve. Silenciarlo una vez no entierra lo que el equipo escriba el mes que viene.
Historial de versiones
Cada guardado que cambia el título, el contenido o el enlace de un recurso deja una instantánea. El panel Historial aparece junto al recurso para quien puede editarlo: las seis versiones más recientes, con las anteriores tras un desplegable. Cada entrada indica quién la guardó y qué campos cambiaron.
Ver abre una versión pasada. Restaurar vuelve a aplicarla, y restaurar es una acción hacia delante: escribe una versión nueva con el contenido antiguo en lugar de rebobinar el rastro. No se borra nada, y siempre puedes volver restaurando otra vez.
Al eliminar un recurso se elimina su historial con él.
Encontrar un recurso
| Dónde | Con qué coincide |
|---|---|
| Filtro en la página de un manual (aparece a partir de 8 recursos) | Fragmento del título, del contenido o de la URL |
| Cmd+K | Nombres de manuales y títulos de recursos |
hiring_search_playbooks (agentes) |
Texto completo, ordenado por relevancia, en títulos, contenidos y nombres de manuales |
La búsqueda es por palabras clave, no semántica: «puntuación de la puesta en común» encuentra esas palabras, no una paráfrasis.
Para agentes de IA
Cuatro herramientas de solo lectura. Necesitan acceso a Contratación y el ámbito de lectura de Contratación en la conexión, nada más. Para conectar un cliente, consulta Agente de IA y herramientas MCP.
| Herramienta | Qué devuelve |
|---|---|
hiring_list_playbooks |
Todos los manuales con sus recursos por título, tipo, id, slug y tipos de etapa. Sin el contenido de los documentos: esto es el mapa. |
hiring_get_playbook |
Un manual por id pbk_ o slug, con los contenidos truncados a 2000 caracteres y marcados cuando se truncan. |
hiring_read_resource |
Un recurso por id rsc_ o slug, completo: todo el contenido, o la URL de un enlace. |
hiring_search_playbooks |
Coincidencias ordenadas por relevancia con un fragmento resaltado y el id rsc_ con el que continuar. Los fragmentos son extractos. |
Busca o lista primero y luego usa hiring_read_resource para lo que necesites completo. hiring_get_playbook sirve para ver un manual entero de un vistazo, así que su truncado lo convierte en la última llamada equivocada antes de que un agente responda a una pregunta detallada.
Checklist rápido
- Un manual por tipo de contratación, no uno por equipo
- Marca todo lo procedimental con los tipos de etapa a los que se aplica
- Enlaza al material que ya se mantiene en otro sitio; escribe documentos en Kit solo para aquello de lo que Kit es la sede
- Acierta con el tipo a la primera: después no se puede cambiar
- Pregúntale a tu asistente de IA algo cuya respuesta ya conoces, para comprobar que lee el recurso correcto