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

202 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: mitarbeiter-profil
description: "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'."
compatibility: 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](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](references/interview-guide.md) 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](scripts/auto-enrich.sh) | Phase 1 — einmalig ausführen |
| [references/interview-guide.md](references/interview-guide.md) | Vor Wizard-Start — Fragen-Struktur |
| [references/skill-anchors-cheatsheet.md](references/skill-anchors-cheatsheet.md) | Phase 4 — für die Top 10 IT-Skills die Verhaltensanker |
| [references/competence-catalog-it.md](references/competence-catalog-it.md) | Phase 4 — falls IT |
| [references/competence-catalog-template.md](references/competence-catalog-template.md) | Phase 4 — falls nicht-IT |
| [references/gdpr-de.md](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](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`.
### Phase 3 — link (Vernetzen)
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](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](references/framework-skills-matrix.md) |
| **Belbin (9 Rollen)** | optional | ab Teamgröße 4+, wenn Projektstaffing ansteht | [references/framework-belbin.md](references/framework-belbin.md) |
| **CliftonStrengths** | optional | nur wenn Kollege den Gallup-Test gemacht hat (~25€) | [references/framework-cliftonstrengths.md](references/framework-cliftonstrengths.md) |
| **T-Shape** | empfohlen | zur Visualisierung Specialist vs Generalist | [references/framework-t-shape.md](references/framework-t-shape.md) |
## GDPR-Pflichten (Kurzfassung)
Die ausführliche rechtliche Grundlage mit Templates steht in [references/gdpr-de.md](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](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](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](references/framework-skills-matrix.md) | Vor jeder Skills-Bewertung; bei Rating-Unsicherheit |
| [references/framework-belbin.md](references/framework-belbin.md) | Wenn Teamrollen profiling oder Projektstaffing ansteht |
| [references/framework-cliftonstrengths.md](references/framework-cliftonstrengths.md) | Wenn ein Kollege CliftonStrengths-Testergebnisse vorlegen kann |
| [references/framework-t-shape.md](references/framework-t-shape.md) | Zur Visualisierung Specialist-vs-Generalist-Karriereplanung |
| [references/gdpr-de.md](references/gdpr-de.md) | Vor jeder Profil-Anlage; bei DSAR-Anfragen; jährlich für LIA-Review |
| [references/competence-catalog-it.md](references/competence-catalog-it.md) | Wenn IT-Profile erstellt werden |
| [references/competence-catalog-template.md](references/competence-catalog-template.md) | Wenn ein nicht-IT-Abteilungsleiter den Skill übernimmt |
| [assets/person-template.md](assets/person-template.md) | Beim Anlegen eines neuen Profils — kopieren und ausfüllen |
| [scripts/auto-enrich.sh](scripts/auto-enrich.sh) | Vor jedem Wizard — Phase 1 Auto-Enrichment |
| [references/interview-guide.md](references/interview-guide.md) | Vor Wizard-Start — Fragen-Struktur für Phasen 0-9 |
| [references/skill-anchors-cheatsheet.md](references/skill-anchors-cheatsheet.md) | Phase 4 — Verhaltensanker Top 10 IT-Skills |