Automatischer Push: 14 Datei(en) geändert
- .vault-tools/plan-kopie/LIESMICH.md - .vault-tools/plan-kopie/rot_nachweis.py - .vault-tools/trading-plattform-pruefung/LIESMICH.md - .vault-tools/trading-plattform-pruefung/dienste_stand.sh - .vault-tools/trading-plattform-pruefung/ha_einrichten.py - .vault-tools/trading-plattform-pruefung/hole_kerzen.py - .vault-tools/trading-plattform-pruefung/neustart_echtlauf.py - .vault-tools/trading-plattform-pruefung/ntfy_lesen.py - .vault-tools/trading-plattform-pruefung/pause_echtlauf.py - .vault-tools/trading-plattform-pruefung/wiederanlauf_probe.ps1 - AI/Regelwerk/codeworkflow.md - AI/Regelwerk/projekte.md - … und 2 weitere Erzeugt vom PostToolUse-Hook .vault-tools/auto-push/auto_push.py. Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
1 parent
395642c480
commit
246af19683
14 files changed
+964
-7
No files matched your search
@@ -0,0 +1,107 @@
|
||||
---
|
||||
type: resource
|
||||
title: "Wiederkehrende Jobs als Playbook"
|
||||
status: reference
|
||||
summary: "Wie aus einem wiederkehrenden Job ein Skill wird, den der Agent ohne Pascal erledigt: Interview mit einer Frage je Nachricht, SKILL.md mit festen Abschnitten, Fertig-heißt-Checks mit Beleg und die Ablage für wiederverwendbare Dateien."
|
||||
tags: [regelwerk, playbook, skills, abnahme]
|
||||
created: 2026-09-20
|
||||
updated: 2026-09-20
|
||||
---
|
||||
|
||||
# Wiederkehrende Jobs als Playbook
|
||||
|
||||
Angeordnet am 2026-09-20. Gilt, sobald Pascal einen Job abgeben will, den er immer wieder macht. Am Ende steht ein Skill, mit dem du den Job ohne Rückfrage erledigst.
|
||||
|
||||
Die Abschnitte 3 („Fertig heißt“) und 4 (Ablage) gelten auch außerhalb solcher Jobs. Wo sie in Projekten greifen, steht in [[AI/Regelwerk/codeworkflow|codeworkflow.md]] (Schritte 2 und 6) und in [[AI/Regelwerk/projekte|projekte.md]] (Regel 7). Die Form der Checks steht nur hier.
|
||||
|
||||
## 1 Interview — erst fragen, dann schreiben
|
||||
|
||||
Pascal beschreibt den Job in einer Zeile. Danach interviewst du ihn:
|
||||
|
||||
- **Immer nur eine Frage je Nachricht.** Dann wartest du auf die Antwort.
|
||||
- **Du schreibst keine Datei, bevor zwei Dinge erfüllt sind:** Du hast mindestens acht Fragen gestellt, und Pascal hat gesagt, dass ihr fertig seid. Eins von beiden reicht nicht.
|
||||
|
||||
Das Interview deckt alles hier ab:
|
||||
|
||||
- was den Job auslöst und wie oft er ansteht
|
||||
- die Eingaben und wo genau jede davon liegt
|
||||
- die Schritte in der Reihenfolge, in der Pascal sie wirklich macht
|
||||
- jede Entscheidung, die er trifft, und die Regel dahinter
|
||||
- was er prüft, bevor er etwas fertig nennt
|
||||
- die Sonderfälle, die schon mal schiefgegangen sind
|
||||
- den Ton oder Standard, den das Ergebnis treffen muss
|
||||
- wie eine schlechte Version aussieht
|
||||
|
||||
Das ist die Ausnahme zu Schritt 1 der Standardschleife („nur Fragen, deren Antwort die Arbeit verändert“). Dort liegt das meiste im Code. Hier liegt der Ablauf nur in Pascals Kopf, und jede nicht gestellte Frage wird später eine Annahme im Skill.
|
||||
|
||||
## 2 Die SKILL.md
|
||||
|
||||
Sobald du den Job ohne Pascal erledigen könntest, legst du `.claude/skills/<job-name>/SKILL.md` an. Der Ordnername ist kebab-case, ohne Datum und ohne Version. Das Frontmatter hat das Claude-Code-Format mit `name` und `description`; die `description` steht in Anführungszeichen ([[AI/Regelwerk/frontmatter|frontmatter.md]], „Quoting“).
|
||||
|
||||
Die Abschnitte, in dieser Reihenfolge:
|
||||
|
||||
1. **Zweck** — eine Zeile.
|
||||
2. **Wann nutzen**
|
||||
3. **Eingaben** — jede mit ihrem Ort.
|
||||
4. **Schritte** — nummeriert, in einfacher Sprache, kein Fachchinesisch.
|
||||
5. **Entscheidungen** — in der Form „wenn X, dann Y“.
|
||||
6. **Fertig heißt** — nach Abschnitt 3.
|
||||
7. **Sonderfälle**
|
||||
|
||||
Danach zeigst du Pascal die komplette Datei und stellst zwei Fragen: Was habe ich falsch verstanden? Was hast du vergessen, mir zu sagen?
|
||||
|
||||
Zwei Dinge aus dem Vault kommen dazu:
|
||||
|
||||
- **Der Skill verweist auf das Regelwerk, statt es zu kopieren.** Braucht ein Schritt den Schreibstil oder die Windows-Shell-Regeln, nennt er die Datei.
|
||||
- **`.claude/skills/` wird täglich um 04:00 veröffentlicht, ohne Freigabe** ([[AI/Regelwerk/veroeffentlichung|veroeffentlichung.md]]). In SKILL.md und Ablage stehen deshalb keine Kundennamen, Domains, IP-Adressen oder Zugangsdaten. Hängt der Job an einem Kunden, liegen dessen Details außerhalb von `.claude/skills/`, und der Skill nennt nur den Pfad.
|
||||
|
||||
## 3 Fertig heißt
|
||||
|
||||
Der Abschnitt „Fertig heißt“ enthält fünf bis zehn Checks, die speziell zu diesem Job passen. **Jeder Check ist mit einem Beleg außerhalb deiner eigenen Meinung prüfbar:**
|
||||
|
||||
- eine Zahl, die bis zu ihrer Quelldatei zurückgeht
|
||||
- ein Link, der lädt
|
||||
- ein Screenshot vom fertigen Ergebnis
|
||||
- ein Test, der läuft
|
||||
- eine Aussage, die zu einem Zitat passt
|
||||
- eine Zählung oder ein Wert, der gegen eine Referenzdatei geprüft ist
|
||||
|
||||
Schwammige Qualitätswörter wie „klar“, „professionell“ oder „hochwertig“ sind kein Check. Niemand kann sie nachmessen, du auch nicht.
|
||||
|
||||
**Jedes Mal, wenn du den Job fertig hast, und bevor du Pascal irgendetwas zeigst:**
|
||||
|
||||
1. Führ jeden Check aus.
|
||||
2. Reparier, was durchfällt.
|
||||
3. Führ alle Checks noch einmal aus, nicht nur die reparierten.
|
||||
4. Gib Pascal je Check eine Zeile: bestanden oder nicht bestanden, mit dem Beleg, den du benutzt hast.
|
||||
5. Nenn alles, was du nicht prüfen konntest, und warum. Nimm nicht an, dass es passt.
|
||||
|
||||
**Fallen beim ersten Durchlauf mehr als zwei Checks durch, hörst du auf.** Du sagst Pascal, welcher Teil des Ablaufs das verursacht hat, statt das Ergebnis zu flicken. Drei kaputte Checks sind ein Fehler im Ablauf, und den findet man nicht, indem man das Ergebnis repariert.
|
||||
|
||||
Wird aus einem Check ein Skript, gilt [[AI/Regelwerk/pruefwerkzeuge|pruefwerkzeuge.md]]: Es zählt erst, wenn du es an kaputter Eingabe hast anschlagen sehen.
|
||||
|
||||
## 4 Ablage — was du wieder brauchst, baust du nur einmal
|
||||
|
||||
Ist bei einem Job etwas entstanden, das Pascal noch einmal braucht (ein Skript, eine Vorlage, eine E-Mail, eine Checkliste), dann:
|
||||
|
||||
1. Speicher es in `<job-name>/ablage/` mit einem sprechenden Namen, zum Beispiel `zahlen-ziehen.py` oder `update-vorlage.md`. Kein Datum und keine Versionsnummer im Namen.
|
||||
2. Ersetz Pascals Details durch Platzhalter in eckigen Klammern, damit es wiederverwendbar ist. Darunter bleibt ein ausgefülltes Beispiel als Referenz stehen. Wegen der Veröffentlichung ist das Beispiel mit neutralen Werten gefüllt, nicht mit echten Kundendaten.
|
||||
3. Aktualisier die SKILL.md: Der Schritt, der die Datei braucht, nennt sie beim Namen. Dazu steht, wann sie genutzt wird und wann nicht.
|
||||
4. Trag eine Zeile in `<job-name>/ablage/INDEX.md` ein: Dateiname, wofür sie da ist, heutiges Datum. Die `INDEX.md` ist ein Verzeichnis und bekommt kein Frontmatter.
|
||||
|
||||
**Nicht in die Ablage:** einmalige Ergebnisse, nichts mit Passwort oder API-Schlüssel, und kein Entwurf, den Pascal nicht freigegeben hat.
|
||||
|
||||
Danach erledigst du den ganzen Job noch einmal von vorn. Du sagst Pascal, welche gespeicherten Dateien du benutzt hast und welche Teile du komplett neu gebaut hast. Alles neu Gebaute ist ein Kandidat für die Ablage. Du sagst also auch, was du als Nächstes speichern würdest.
|
||||
|
||||
## 5 Wenn du keine Dateien schreiben kannst
|
||||
|
||||
In Claude Code kannst du schreiben. In einer Sitzung ohne Dateizugriff tust du nicht so, als hättest du es getan. Du gibst den kompletten Dateiinhalt im Chat aus, nennst den genauen Dateinamen und wo er in den Ordner gehört. Und du erinnerst Pascal daran, die alte hochgeladene Datei zu ersetzen, statt eine zweite anzulegen.
|
||||
|
||||
## Referenzen
|
||||
|
||||
- [[CLAUDE|↑ Claude.md (Stamm)]]
|
||||
- [[AI/Regelwerk/codeworkflow|codeworkflow.md]] — „Fertig heißt“ als Abnahme im Plan und vor der Fertigmeldung
|
||||
- [[AI/Regelwerk/projekte|projekte.md]] — wiederkehrende Arbeit im Projekt
|
||||
- [[AI/Regelwerk/pruefwerkzeuge|pruefwerkzeuge.md]] — wenn ein Check ein Skript wird
|
||||
- [[AI/Regelwerk/veroeffentlichung|veroeffentlichung.md]] — warum Skill und Ablage keine Kundendaten tragen
|
||||
- [[AI/Regelwerk/frontmatter|frontmatter.md]] — Quoting der `description`
|
||||
Reference in new issue
Block a user