12 KiB
name, description, compatibility
| name | description | compatibility |
|---|---|---|
| mitarbeiter-profil | Erstellt und pflegt OKF Person-Konzepte für Kollegen in .okf/organization/. Use when: (1) Anlage eines neuen Kollegen-Profils, (2) Quarterly Profile Review / Aktualisierung, (3) Projektplanung braucht Skills- oder Kapazitäts-Suche ('wer kann X machen?'), (4) Onboarding-Tag-3-Profil-Anlage, (5) Delegation-Decision-Support. Trigger: 'Mitarbeiterprofil', 'Kollegen-Profil', 'Skill-Matrix für X', 'Profil für NN anlegen', 'wer hat Kapazität', 'wer kennt sich aus mit Y', 'Belbin-Rolle für NN'. | opencode |
mitarbeiter-profil
Skill zum Erstellen und Pflegen von OKF Person-Konzepten für Kollegen in .okf/organization/. Die Profile dienen der Projektplanung, Kapazitätssteuerung, Delegation und Personalentwicklung — nicht der Leistungsbeurteilung.
Prinzipien
- Berufsrelevanz nur. Keine privaten Daten, keine Performance-Ratings, keine Gehaltsdaten. Siehe references/gdpr-de.md.
- Selbstauskunft statt Fremdbewertung. Kollegen pflegen ihre Skills selbst. Vorgesetzter verifiziert.
- Aktuell halten. Jedes Profil hat ein
stale_after-Datum (180 Tage). Danach Review pflicht. - Verlinkt, nicht dupliziert. Projekt-Zugehörigkeiten verlinken auf
../projects/, nicht abschreiben. - Generisch einsetzbar. Dieser Skill ist nicht IT-exklusiv. Beispiele sind IT, das Schema gilt für alle Abteilungen.
Workflow
Interactive Wizard (Empfohlener Modus)
Für Abteilungsleiter, die ein neues Profil erstellen, gibt es einen geführten Wizard. Der Agent lädt den Interview-Guide und gehtPhase für Phase durch, eine Frage pro Nachricht.
Wizard-Phasen
Phase 0 Pre-Flight → Privacy Notice passiert?
Phase 1 Auto-Enrichment → bash scripts/auto-enrich.sh "<Name>"
Phase 2 Identität → 4-5 Fragen (Titel, Standort, Tenure, Vorgesetzter, E-Mail)
Phase 3 Hintergrund → 3 Fragen (Ausbildung, Stationen, Zertifikate)
Phase 4 Skills Assessment → 5-15 Fragen (Question-Tool mit Verhaltensankern)
Phase 5 Team-Profil → optional (Belbin, CliftonStrengths, Arbeitsstil)
Phase 6 Kapazität → 3 Fragen (Verfügbarkeit, Projekte, Engagement-Art)
Phase 7 Wachstum → 3 Fragen (Skills, Rollen, Mentoring)
Phase 8 Draft-Review → Profil schreiben, User-Approval
Phase 9 Verify-Plan → Checkliste, nächste Schritte
Wizard-Trigger
Wizard startet automatisch, wenn User sagt:
- „Erstelle Profil für [Name]"
- „Profil-Interview mit [Name]"
- „Profile-Wizard für [Name]"
- „Mitarbeiterprofil anlegen: [Name]"
Wizard startet nicht bei:
- Aktualisierung eines bestehenden Profils → nutze „refresh" Workflow
- Suche nach existierenden Profilen → nutze
grep -r "Skill X" .okf/organization/ - Pure Skill-Level-Fragen → beantworte direkt ohne Wizard
Wizard-Hard-Gates
Der Agent DARF NICHT:
- Das Profil schreiben, bevor der User den Draft gesehen und bestätigt hat (Phase 8).
- Belbin-Rollen oder CliftonStrengths raten — nur was der User (oder ein Test) sagt.
- Skills-Level ≥3 ohne Beleg akzeptieren (Ticket, Zertifikat, Commit).
- Sensible Felder erfragen (Performance, Gehalt, etc.) — verboten per Option A.
- Block-Fragen stellen — immer eine Frage pro Nachricht.
- Ohne Privacy Notice weitermachen (Phase 0 Pflicht).
Wizard-Ressourcen
| Resource | Wann laden? |
|---|---|
| scripts/auto-enrich.sh | Phase 1 — einmalig ausführen |
| references/interview-guide.md | Vor Wizard-Start — Fragen-Struktur |
| references/skill-anchors-cheatsheet.md | Phase 4 — für die Top 10 IT-Skills die Verhaltensanker |
| references/competence-catalog-it.md | Phase 4 — falls IT |
| references/competence-catalog-template.md | Phase 4 — falls nicht-IT |
| references/gdpr-de.md | Phase 0 — Privacy Notice Template holen |
Auto-Enrichment Quellen
Das Auto-Enrichment-Script durchsucht nur Quellen, die für alle AZ-Abteilungsleiter verfügbar sind:
- ✅ Basecamp — Volltextsuche + Person-Record aus Creator-Feldern
- ✅ OKF-Bundle im lokalen Repo (
$OKF_DIR, default.okf) - ✅ NixOS User-Configs (optional, IT-only;
$NIX_DIRenv var)
Nicht durchsucht (bewusst weggelassen):
- ❌
m3ta-brainvault (privat, nur Sascha — nicht sharebar) - ❌ Opencode Session-Logs (privat, nur Sascha)
Wenn der User eine Quelle ausschließen will: NIX_DIR=/dev/null OKF_DIR=/tmp ./auto-enrich.sh "Name" überschreibt.
Phase 1 — create (Profil anlegen)
- Privacy Notice: Kollege über Zweck, Rechtsgrundlage (§ 26 BDSG), Speicherdauer informieren. Vorlage in references/gdpr-de.md.
- Datei anlegen:
cp assets/person-template.md <repo>/.okf/organization/<vorname>-<nachname>.md. - Frontmatter ausfüllen:
title,description,tags,generated.at(heute),stale_after(heute + 180 Tage),consent.notice_given_at(heute). - Body ausfüllen: Identität, Hintergrund, Skills-Matrix (start mit 3–5 Kern-Skills, nicht allen), Team-Profil (Belbin/CliftonStrengths nur wenn bereits bekannt), Aktuelle Kapazität, Wachstumsplan.
- Cross-Links: Auf Abteilung, aktive Projekte, relevante Entscheidungen verlinken.
- Status bleibt
draftbis Phase 2 abgeschlossen.
Phase 2 — verify (Review)
- Kollege liest den Entwurf und ergänzt/korrigiert (selbst-Ausnahme: nur berufsrelevante Skills).
- Vorgesetzter bestätigt die Skills-Level mit konkretem Beleg (Projekt, Zertifikat, Ticket).
verified-Array im Frontmatter füllen:- by: "human:<vorgesetzter-slug>", at: "YYYY-MM-DD".- Status auf
stableändern. log.mdim OKF-Bundle-root erhält Eintrag:YYYY-MM-DD: Profil <slug> angelegt/aktualisiert.
Phase 3 — link (Vernetzen)
- Projekte: in jedem verlinkten
../projects/<x>.mdprüfen, ob die Person im Team- oder DRI-Feld steht. Wenn nein → ergänzen. - Entscheidungen: auf
../decisions/<x>.mdverlinken, wo die Person Sign-off gegeben hat. - Abteilung: in
../organization/<abteilung>.mdggf. Team-Mitglieder-Liste ergänzen.
Phase 4 — refresh (Pflege)
- Trigger:
stale_aftererreicht, Projekt-Abschluss, Rollenwechsel, neue Zertifizierung, Quarterly Review. - Selbsteinschätzung aktualisieren: Kollege ändert Skills-Level und
generated.at. - Vorgesetzter re-verifiziert:
verified-Array erhält neuen Eintrag. stale_afterverschieben: +180 Tage ab heute.log.mdaktualisieren.
Phase 5 — use (Anwendung)
- Projektplanung: „Wer hat Skill X mindestens Level 3?" →
grep -r "Skill X" .okf/organization/. - Kapazitäts-Check: Verfügbarkeit in jedem Profil summiert = freie Kapazität.
- Team-Composition: Belbin-Rollen aus allen Profilen → sind alle 3 Familien (Thinking/People/Action) vertreten?
- Delegation: Wachstumsplan-Feld „Skills to develop" zeigt, wem eine Aufgabe hilft.
Profil-Struktur (Feld-Katalog)
Ausführliches Template mit allen Feldern: assets/person-template.md.
| Block | Felder | Pflicht? |
|---|---|---|
| Frontmatter | type: Person, title, description, tags, status, generated, verified, stale_after, consent |
type/status/generated/consent ja |
| Identität | Titel, Vorgesetzter, Abteilung, Standort, Zeitzone, Tenure | ja |
| Hintergrund | Werdegang, Zertifizierungen | ja (kann „k.A." sein) |
| Skills-Matrix | Technical, Domain, Soft Skills je mit Level 0–5 | ja (mindestens 3 Skills) |
| T-Shape | depth (Specialist), breadth (Generalist) | empfohlen |
| Team-Profil | Belbin (primär/sekundär), CliftonStrengths Top-5, Arbeitsstil-Notizen | optional |
| Aktuelle Kapazität | Verfügbarkeits-%, aktive Projekte, Engagement-Präferenz | ja |
| Wachstumsplan | Skills zu entwickeln, Rollen von Interesse, Mentoring-Bereitschaft | ja |
| Projekt-Historie | Auszugsweise, mit Links | empfohlen |
| Quellen / Belege | Footnotes für spezifische Behauptungen | bei Assessment-Claims |
Framework-Auswahl
| Framework | Pflicht? | Wann verwenden? | Referenz |
|---|---|---|---|
| Skills-Matrix 0–5 | ja | immer — Core jeder Profilkategorie | references/framework-skills-matrix.md |
| Belbin (9 Rollen) | optional | ab Teamgröße 4+, wenn Projektstaffing ansteht | references/framework-belbin.md |
| CliftonStrengths | optional | nur wenn Kollege den Gallup-Test gemacht hat (~25€) | references/framework-cliftonstrengths.md |
| T-Shape | empfohlen | zur Visualisierung Specialist vs Generalist | references/framework-t-shape.md |
GDPR-Pflichten (Kurzfassung)
Die ausführliche rechtliche Grundlage mit Templates steht in references/gdpr-de.md. Die harten Regeln:
- Rechtsgrundlage: § 26 Abs. 1 BDSG (Durchführung Arbeitsverhältnis) + Art. 6 Abs. 1b DSGVO. Keine Einwilligung nötig für berufsrelevante Daten.
- Datenminimierung: nur beruflich relevante Felder. Privatleben, Familie, Hobbys, Gewerkschaft → verboten ohne freiwillige Einwilligung.
- Ganz verboten: Performance-Ratings, 9-Box, Potenzialeinschätzungen, Gehalt, disziplinarische Maßnahmen, Gesundheits-/Krankenstandsdaten. Diese gehören nie in ein Profil dieses Skills.
- Privacy Notice muss vor Profil-Anlage dem Kollegen mitgeteilt worden sein (Datum im
consent.notice_given_at). - Staleness:
stale_afterPflichtfeld — spätestens nach 180 Tagen Review oder Löschung. - Repo muss private sein. Niemals auf öffentliche Remote pushen.
- Keine KI-gestützten Scores aus nicht-beruflichen Daten (Social Scoring nach Art. 5 KI-VO verboten).
Eigene Kompetenzkataloge (für nicht-IT-Abteilungsleiter)
IT-spezifischer Beispielkatalog: references/competence-catalog-it.md.
Für Sales, Vertrieb, HR, Produktion, Finance etc. eigenen Katalog bauen:
- 3–7 Kompetenz-Familien für die Abteilung definieren.
- Pro Familie 3–10 konkrete Skills benennen.
- Level-3-Verhaltensanker formulieren („kann selbstständig …").
- Level-5-Verhaltensanker formulieren („setzt Standards, coacht andere").
Vorlage und Beispiele: references/competence-catalog-template.md.
Validierung & Commit
- OKF validieren:
/okf:validate .okf --strictaufrufen. JedenERROR(§11) beheben;WARNsind soft. - YAML-Frontmatter parsen:
python3 -c "import yaml; yaml.safe_load(open('DATEI.md').read().split('---')[1])". - Zeilenlimit prüfen: SKILL.md < 500 Zeilen, references/*.md < 1000 Zeilen.
- Commit: mit
process:chiron-agentalsgenerated.by. Conventional-commit-style:add: person profile <slug>. - Push nur in private Repos.
Referenzen
| Datei | Wann lesen? |
|---|---|
| references/framework-skills-matrix.md | Vor jeder Skills-Bewertung; bei Rating-Unsicherheit |
| references/framework-belbin.md | Wenn Teamrollen profiling oder Projektstaffing ansteht |
| references/framework-cliftonstrengths.md | Wenn ein Kollege CliftonStrengths-Testergebnisse vorlegen kann |
| references/framework-t-shape.md | Zur Visualisierung Specialist-vs-Generalist-Karriereplanung |
| references/gdpr-de.md | Vor jeder Profil-Anlage; bei DSAR-Anfragen; jährlich für LIA-Review |
| references/competence-catalog-it.md | Wenn IT-Profile erstellt werden |
| references/competence-catalog-template.md | Wenn ein nicht-IT-Abteilungsleiter den Skill übernimmt |
| assets/person-template.md | Beim Anlegen eines neuen Profils — kopieren und ausfüllen |
| scripts/auto-enrich.sh | Vor jedem Wizard — Phase 1 Auto-Enrichment |
| references/interview-guide.md | Vor Wizard-Start — Fragen-Struktur für Phasen 0-9 |
| references/skill-anchors-cheatsheet.md | Phase 4 — Verhaltensanker Top 10 IT-Skills |