Manuels de recrutement

Une bibliothèque réservée à l'équipe pour le matériel de recrutement que vous réutilisez. Documents et liens, associés à des types d'étapes pour que Kit les propose lors de la configuration et que les agents IA puissent les lire.

Les manuels se trouvent sous Recrutement → Manuels, à l’adresse /hiring/playbooks. Un manuel est un ensemble nommé de ressources : des documents Markdown rédigés dans Kit, et des liens vers du matériel hébergé ailleurs.

Rien de ce que contient un manuel n’est jamais montré aux candidats. C’est le manuel interne de votre équipe : le portail carrière, le portail candidat et les e-mails de candidature n’y puisent jamais.

Le manuel d’une équipe d’ingénierie peut contenir :

Ressource	Type
Vidéo de présentation de l’entreprise	Lien (YouTube, lecteur intégré)
Comment nous menons le premier entretien	Document
Liste de contrôle pour la revue de code (backend)	Document
Banque de questions sur l’adéquation culturelle	Document
Logistique de la journée sur site (Google Doc)	Lien

Qui peut faire quoi

	Lecture	Créer, modifier, supprimer, réordonner
Membre du Recrutement	Oui	Non
Administrateur du Recrutement	Oui	Oui

Les niveaux sont définis par module : un administrateur du Recrutement qui n’est que membre en Prospection conserve ici tous les droits d’écriture. Voir Rôles d’équipe.

Documents et liens

Un document est du Markdown que vous rédigez dans Kit. L’éditeur propose un sélecteur Rédiger / Aperçu ; les titres, les tableaux, les listes de tâches, le texte barré et les URL brutes sont tous rendus. Le HTML brut est supprimé, pas échappé. Le contenu est plafonné à 100 000 caractères.

Un lien est une URL vers un contenu que vous conservez déjà ailleurs. Appuyez sur Charger l’aperçu : les liens YouTube, Vimeo et Loom obtiennent un lecteur intégré ; tout le reste est enregistré comme simple lien, ce qui est le cas courant pour la documentation et les wikis. Il n’y a pas de téléversement de fichiers : laissez le fichier là où il vit déjà et créez un lien vers lui.

Warning

Le type d’une ressource est figé dès l’enregistrement. Un document ne peut pas devenir un lien par la suite, ni l’inverse : le changement laisserait orphelins le contenu et chacune de ses versions. Pour changer de type, créez une nouvelle ressource et supprimez l’ancienne.

Les administrateurs peuvent faire glisser les ressources pour les réordonner sur la page du manuel. Le réordonnancement est désactivé tant que le champ de filtre est utilisé, une liste filtrée n’étant qu’un sous-ensemble.

Suggestions lors de la configuration d’une étape

Lorsque vous ajoutez ou modifiez une ressource, cochez des types d’étapes sous Suggérer lors de la configuration d’une étape : Déposer une candidature, Exercice de code, Entretien, Offre, Revue de portfolio, Questionnaire, Vérification des références, Appel de présélection, Mise en situation, Revue d’équipe, Présentation vidéo, Réponse vidéo. Revue de portfolio désigne des travaux antérieurs ; Mise en situation, une nouvelle tâche assortie d’un énoncé privé.

Un collègue qui ouvre une étape de ce type voit alors un panneau Extrait de vos manuels listant les ressources associées. Chacune s’ouvre dans un nouvel onglet, pour ne rien perdre de ce qui n’est pas encore enregistré sur l’étape.

Le panneau dispose d’un bouton pour le masquer, et ce masquage est volontairement étroit :

Par personne. Le masquer ne le masque jamais pour quelqu’un d’autre.
Par type d’étape. Le masquer sur les étapes Entretien le laisse visible sur les étapes Exercice de code.
Ramené par tout ajout ultérieur. Une ressource associée après qu’une personne a masqué le panneau le fait revenir pour elle. Le masquer une fois n’enterre pas ce que l’équipe écrira le mois prochain.

Historique des versions

Chaque enregistrement qui modifie le titre, le contenu ou le lien d’une ressource écrit un instantané. Les personnes autorisées à la modifier voient en dessous un volet compact Historique. Il reste fermé par défaut pour donner la priorité au document. Une fois ouvert, il affiche les six versions les plus récentes ; les plus anciennes sont rangées derrière un second volet. Chaque entrée indique qui a enregistré et quels champs ont changé.

Voir ouvre une version antérieure. Restaurer la réapplique. Restaurer va toujours de l’avant : cela écrit une nouvelle version contenant l’ancien contenu, au lieu de rembobiner l’historique. Rien n’est effacé, et vous pouvez remonter le temps par restaurations successives.

Supprimer une ressource supprime son historique avec elle.

Retrouver une ressource

Où	Ce qui est comparé
Champ de filtre sur la page d’un manuel (apparaît au-delà de 8 ressources)	Une portion du titre, du contenu ou du lien
Cmd+K	Noms de manuels et titres de ressources
`hiring_search_playbooks` (agents)	Plein texte, classé, sur les titres, les contenus et les noms de manuels

La recherche fonctionne par mots-clés, pas par sens : « notation du compte rendu » trouve ces mots, pas une paraphrase.

Pour les agents IA

Six outils couvrent le cycle de recherche, de création et de vérification. Les quatre outils de lecture exigent un accès au module Recrutement et une portée hiring_read ou hiring_write accordée à la connexion. Les deux outils d’écriture exigent précisément hiring_write, un abonnement actif et des droits d’administration sur le module Recrutement. Pour connecter un client, voir Agent IA et outils MCP.

Outil	Ce qu’il renvoie
`hiring_list_playbooks`	Tous les manuels avec leurs ressources : titre, type, id, slug et types d’étapes. Aucun contenu de document : c’est la carte.
`hiring_get_playbook`	Un manuel par id `pbk_` ou slug, avec les contenus tronqués à 2 000 caractères et signalés comme tels.
`hiring_read_resource`	Une ressource par id `rsc_` ou slug, en entier, c’est-à-dire le contenu complet, ou l’URL d’un lien.
`hiring_search_playbooks`	Les correspondances classées, avec un extrait mis en évidence et l’id `rsc_` pour aller plus loin. Ces extraits restent partiels.
`hiring_create_playbook`	Un nouveau manuel vide, réservé à l’équipe. Renvoie son id `pbk_` et son URL web.
`hiring_add_resource`	Ajoute un document ou un lien à la fin d’un manuel. Vous pouvez indiquer les types d’étapes pour lesquels Kit doit suggérer cette ressource. Renvoie son id `rsc_` pour vérification.

Listez ou cherchez d’abord pour éviter les doublons. Créez le manuel si nécessaire, ajoutez les ressources une par une, puis vérifiez le résultat avec hiring_get_playbook ou hiring_read_resource. hiring_get_playbook donne une vue d’ensemble d’un manuel ; sa troncature en fait donc un mauvais dernier appel avant qu’un agent réponde à une question précise.

Checklist

Un manuel par type de recrutement, pas un par équipe
Associez toute ressource procédurale aux types d’étapes qu’elle concerne
Créez des liens vers le matériel déjà maintenu ailleurs ; ne rédigez des documents dans Kit que pour ce dont Kit est le lieu naturel
Choisissez le bon type du premier coup, car il ne pourra plus être changé
Posez à votre assistant IA une question dont vous connaissez déjà la réponse, pour vérifier qu’il lit la bonne ressource