feat: add own skills

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Sascha KönigandClaude Opus 5.5 committed 2026-11-01 15:59:55 +01:00
1 parent 02e2797fbd
commit ac6208717c
41 files changed
+4632

No files matched your search

+201
View File
@@ -0,0 +1,201 @@
---
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 |