Files
agent-prod/skills/mitarbeiter-profil/SKILL.md
T
2026-11-01 15:59:55 +01:00

12 KiB
Raw Blame History

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

  1. Berufsrelevanz nur. Keine privaten Daten, keine Performance-Ratings, keine Gehaltsdaten. Siehe references/gdpr-de.md.
  2. Selbstauskunft statt Fremdbewertung. Kollegen pflegen ihre Skills selbst. Vorgesetzter verifiziert.
  3. Aktuell halten. Jedes Profil hat ein stale_after-Datum (180 Tage). Danach Review pflicht.
  4. Verlinkt, nicht dupliziert. Projekt-Zugehörigkeiten verlinken auf ../projects/, nicht abschreiben.
  5. 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:

  1. Das Profil schreiben, bevor der User den Draft gesehen und bestätigt hat (Phase 8).
  2. Belbin-Rollen oder CliftonStrengths raten — nur was der User (oder ein Test) sagt.
  3. Skills-Level ≥3 ohne Beleg akzeptieren (Ticket, Zertifikat, Commit).
  4. Sensible Felder erfragen (Performance, Gehalt, etc.) — verboten per Option A.
  5. Block-Fragen stellen — immer eine Frage pro Nachricht.
  6. 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_DIR env var)

Nicht durchsucht (bewusst weggelassen):

  • ❌ m3ta-brain vault (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)

  1. Privacy Notice: Kollege über Zweck, Rechtsgrundlage (§ 26 BDSG), Speicherdauer informieren. Vorlage in references/gdpr-de.md.
  2. Datei anlegen: cp assets/person-template.md <repo>/.okf/organization/<vorname>-<nachname>.md.
  3. Frontmatter ausfüllen: title, description, tags, generated.at (heute), stale_after (heute + 180 Tage), consent.notice_given_at (heute).
  4. 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.
  5. Cross-Links: Auf Abteilung, aktive Projekte, relevante Entscheidungen verlinken.
  6. Status bleibt draft bis Phase 2 abgeschlossen.

Phase 2 — verify (Review)

  1. Kollege liest den Entwurf und ergänzt/korrigiert (selbst-Ausnahme: nur berufsrelevante Skills).
  2. Vorgesetzter bestätigt die Skills-Level mit konkretem Beleg (Projekt, Zertifikat, Ticket).
  3. verified-Array im Frontmatter füllen: - by: "human:<vorgesetzter-slug>", at: "YYYY-MM-DD".
  4. Status auf stable ändern.
  5. log.md im OKF-Bundle-root erhält Eintrag: YYYY-MM-DD: Profil <slug> angelegt/aktualisiert.
  1. Projekte: in jedem verlinkten ../projects/<x>.md prüfen, ob die Person im Team- oder DRI-Feld steht. Wenn nein → ergänzen.
  2. Entscheidungen: auf ../decisions/<x>.md verlinken, wo die Person Sign-off gegeben hat.
  3. Abteilung: in ../organization/<abteilung>.md ggf. Team-Mitglieder-Liste ergänzen.

Phase 4 — refresh (Pflege)

  1. Trigger: stale_after erreicht, Projekt-Abschluss, Rollenwechsel, neue Zertifizierung, Quarterly Review.
  2. Selbsteinschätzung aktualisieren: Kollege ändert Skills-Level und generated.at.
  3. Vorgesetzter re-verifiziert: verified-Array erhält neuen Eintrag.
  4. stale_after verschieben: +180 Tage ab heute.
  5. log.md aktualisieren.

Phase 5 — use (Anwendung)

  1. Projektplanung: „Wer hat Skill X mindestens Level 3?" → grep -r "Skill X" .okf/organization/.
  2. Kapazitäts-Check: Verfügbarkeit in jedem Profil summiert = freie Kapazität.
  3. Team-Composition: Belbin-Rollen aus allen Profilen → sind alle 3 Familien (Thinking/People/Action) vertreten?
  4. 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:

  1. Rechtsgrundlage: § 26 Abs. 1 BDSG (Durchführung Arbeitsverhältnis) + Art. 6 Abs. 1b DSGVO. Keine Einwilligung nötig für berufsrelevante Daten.
  2. Datenminimierung: nur beruflich relevante Felder. Privatleben, Familie, Hobbys, Gewerkschaft → verboten ohne freiwillige Einwilligung.
  3. Ganz verboten: Performance-Ratings, 9-Box, Potenzialeinschätzungen, Gehalt, disziplinarische Maßnahmen, Gesundheits-/Krankenstandsdaten. Diese gehören nie in ein Profil dieses Skills.
  4. Privacy Notice muss vor Profil-Anlage dem Kollegen mitgeteilt worden sein (Datum im consent.notice_given_at).
  5. Staleness: stale_after Pflichtfeld — spätestens nach 180 Tagen Review oder Löschung.
  6. Repo muss private sein. Niemals auf öffentliche Remote pushen.
  7. 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:

  1. 3–7 Kompetenz-Familien für die Abteilung definieren.
  2. Pro Familie 3–10 konkrete Skills benennen.
  3. Level-3-Verhaltensanker formulieren („kann selbstständig …").
  4. Level-5-Verhaltensanker formulieren („setzt Standards, coacht andere").

Vorlage und Beispiele: references/competence-catalog-template.md.

Validierung & Commit

  1. OKF validieren: /okf:validate .okf --strict aufrufen. Jeden ERROR (§11) beheben; WARN sind soft.
  2. YAML-Frontmatter parsen: python3 -c "import yaml; yaml.safe_load(open('DATEI.md').read().split('---')[1])".
  3. Zeilenlimit prüfen: SKILL.md < 500 Zeilen, references/*.md < 1000 Zeilen.
  4. Commit: mit process:chiron-agent als generated.by. Conventional-commit-style: add: person profile <slug>.
  5. 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