Hiring-Handbücher

Handbücher finden Sie unter Hiring → Handbücher. Ein Handbuch ist eine benannte Gruppe von Ressourcen: Markdown-Dokumente, die Sie in Kit schreiben, und Links auf Material, das anderswo liegt.

Nichts aus einem Handbuch bekommen Kandidaten je zu sehen. Es ist ausschließlich für Ihr Team bestimmt. Karriereportal, Kandidatenportal und Bewerbungs-E-Mails greifen nie darauf zu.

Das Handbuch eines Entwicklungsteams könnte enthalten:

Ressource	Typ
Vorstellungsvideo des Unternehmens	Link (YouTube, spielt eingebettet)
So führen wir das Erstgespräch	Dokument
Checkliste für Code-Reviews (Backend)	Dokument
Fragenkatalog zum Kulturfit	Dokument
Organisation des Vor-Ort-Tags (Google Doc)	Link

Wer was darf

	Lesen	Erstellen, bearbeiten, löschen, neu anordnen
Hiring-Mitglied	Ja	Nein
Hiring-Admin	Ja	Ja

Die Stufen gelten je Modul: Ein Hiring-Admin, der in Outreach nur Mitglied ist, hat hier trotzdem vollen Schreibzugriff. Siehe Team-Rollen.

Dokumente und Links

Ein Dokument ist Markdown, das Sie in Kit schreiben. Der Editor hat einen Umschalter Schreiben / Vorschau; Überschriften, Tabellen, Aufgabenlisten, Durchgestrichenes und URLs ohne Linksyntax werden gerendert. Rohes HTML wird verworfen, nicht maskiert. Der Inhalt ist auf 100.000 Zeichen begrenzt.

Ein Link ist eine URL auf etwas, das Sie ohnehin anderswo pflegen. Klicken Sie auf Vorschau abrufen: Links zu YouTube, Vimeo und Loom erhalten einen eingebetteten Player, alles andere wird als einfacher Link gespeichert, der Normalfall bei Dokumenten und Wikis. Dateiuploads gibt es nicht: Legen Sie die Datei dort ab, wo sie ohnehin liegt, und verlinken Sie sie.

Auf der Handbuchseite können Administratoren Ressourcen per Ziehen neu anordnen. Solange der Filter aktiv ist, ist das Neuanordnen deaktiviert, denn eine gefilterte Liste zeigt nur einen Ausschnitt.

Vorschläge bei der Phaseneinrichtung

Beim Hinzufügen oder Bearbeiten einer Ressource haken Sie unter Bei der Phaseneinrichtung vorschlagen Phasentypen an: Bewerbung einreichen, Code-Aufgabe, Vorstellungsgespräch, Angebot, Portfolio-Review, Fragebogen, Referenzprüfung, Screening-Anruf, Arbeitsprobe, Teambewertung, Video-Vorstellung, Video-Antwort. Portfolio-Review steht für bereits vorhandene Arbeiten; Arbeitsprobe für eine neue Aufgabe mit privater Aufgabenbeschreibung.

Ein Teammitglied, das eine Phase dieses Typs öffnet, sieht dann den Bereich Aus Ihrem Handbuch mit den hinterlegten Ressourcen. Jede öffnet sich in einem neuen Tab, sodass nichts Ungespeichertes in der Phase verloren geht.

Der Bereich lässt sich ausblenden, und das Ausblenden wirkt bewusst eng:

• Pro Person. Ausblenden blendet ihn für niemanden sonst aus.
• Pro Phasentyp. Bei Phasen vom Typ Vorstellungsgespräch ausgeblendet, bleibt er bei Code-Aufgaben sichtbar.
• Neue Ressourcen machen den Bereich wieder sichtbar. Wird eine weitere Ressource nach dem Ausblenden für diesen Phasentyp hinterlegt, erscheint der Bereich für diese Person erneut.

Versionsverlauf

Jedes Speichern, das Titel, Inhalt oder Link einer Ressource ändert, legt einen Stand ab. Wer die Ressource bearbeiten darf, sieht darunter den kompakten Bereich Verlauf. Er bleibt zunächst geschlossen, damit das Dokument im Mittelpunkt steht. Nach dem Öffnen erscheinen die sechs neuesten Versionen; ältere liegen hinter einem weiteren Umschalter. Jeder Eintrag nennt, wer gespeichert hat und welche Felder sich geändert haben.

Ansehen öffnet eine frühere Version. Wiederherstellen legt eine neue Version mit deren Inhalt an. Die bisherigen Versionen bleiben im Verlauf erhalten und können erneut wiederhergestellt werden.

Wird eine Ressource gelöscht, verschwindet ihr Verlauf mit ihr.

Eine Ressource finden

Wo	Worauf es passt
Filter auf einer Handbuchseite (erscheint ab mehr als 8 Ressourcen)	Teilstring aus Titel, Inhalt oder Link
Cmd+K	Namen von Handbüchern und Titel von Ressourcen
hiring_search_playbooks (Agenten)	Volltext, nach Relevanz sortiert, über Titel, Inhalte und Handbuchnamen

Die Suche arbeitet mit Stichwörtern, nicht semantisch: „Auswertungsgespräch bewerten“ findet genau diese Wörter, keine Umschreibung davon.

Für KI-Agenten

Sechs Tools decken den Ablauf vom Suchen über das Anlegen bis zum Prüfen ab. Die vier Lesetools brauchen Hiring-Zugriff und für die Verbindung einen der Scopes hiring_read oder hiring_write. Die beiden Schreibtools benötigen ausdrücklich hiring_write, ein aktives Abonnement und Hiring-Adminrechte. Wie Sie einen Client verbinden, steht unter KI-Agent und MCP-Tools.

Tool	Liefert
hiring_list_playbooks	Jedes Handbuch mit seinen Ressourcen nach Titel, Typ, ID, Slug und Phasentypen. Keine Dokumentinhalte, das ist die Übersicht.
hiring_get_playbook	Ein Handbuch über pbk_-ID oder Slug, mit Inhalten auf 2.000 Zeichen gekürzt und einem Vermerk, wenn gekürzt wurde.
hiring_read_resource	Eine Ressource über rsc_-ID oder Slug, vollständig, also der ganze Inhalt oder die URL eines Links.
hiring_search_playbooks	Treffer nach Relevanz mit hervorgehobenem Textausschnitt und der rsc_-ID zum Nachfassen. Die Ausschnitte sind Auszüge.
hiring_create_playbook	Ein neues leeres Handbuch nur fürs Team. Liefert seine pbk_-ID und die Web-URL.
hiring_add_resource	Fügt am Ende eines Handbuchs ein Dokument oder einen Link hinzu. Optional können Sie die Phasentypen angeben, bei denen Kit die Ressource vorschlagen soll. Liefert die rsc_-ID zur Prüfung.

Rufen Sie zuerst die Liste ab oder suchen Sie, damit keine Duplikate entstehen. Erstellen Sie bei Bedarf das Handbuch, fügen Sie die Ressourcen einzeln hinzu und prüfen Sie das Ergebnis anschließend mit hiring_get_playbook oder hiring_read_resource. hiring_get_playbook zeigt ein ganzes Handbuch auf einen Blick; wegen der Kürzung ist es der falsche letzte Aufruf, bevor ein Agent eine Detailfrage beantwortet.

Kurz-Check

• Ein Handbuch je Art von Einstellung, nicht eines je Team
• Anleitungen für die Phasentypen hinterlegen, bei denen das Team sie benötigt
• Auf Material verlinken, das anderswo gepflegt wird; Dokumente nur für das in Kit schreiben, wofür Kit der richtige Ort ist
• Den Typ gleich beim ersten Mal richtig wählen, später lässt er sich nicht ändern
• Ihrem KI-Assistenten eine Frage stellen, deren Antwort Sie kennen. So prüfen Sie, ob er die richtige Ressource liest