kimal3 0.4.0-durchstich.3 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -0
- package/claude-plugins/.claude-plugin/marketplace.json +8 -8
- package/claude-plugins/README.md +7 -7
- package/claude-plugins/kimal3-logo/.claude-plugin/plugin.json +6 -6
- package/claude-plugins/kimal3-logo/hooks/hooks.json +1 -1
- package/claude-plugins/kimal3-logo/hooks/register.tsx +80 -80
- package/coach/de/kimal3-coach.md +167 -0
- package/coach/en/kimal3-coach.md +167 -0
- package/dist/arbeitsplatz-dateien.js +1 -1
- package/dist/arbeitsplatz-finden.js +115 -0
- package/dist/arbeitsplatz-suche.js +176 -0
- package/dist/befehle/einrichten.js +250 -32
- package/dist/befehle/kurs.js +77 -0
- package/dist/befehle/login.js +12 -1
- package/dist/befehle/skill-install.js +15 -0
- package/dist/befehle/zeigen-einrichten.js +104 -0
- package/dist/befehle/zeigen-start.js +143 -0
- package/dist/befehle/zeigen.js +288 -0
- package/dist/befehle-katalog-en.js +39 -0
- package/dist/befehle-katalog.js +39 -0
- package/dist/befehlswoerter.js +15 -0
- package/dist/coach-ablegen.js +130 -0
- package/dist/coach-rechnung.js +40 -0
- package/dist/kimal3.js +14 -2
- package/dist/logo-ablegen.js +26 -6
- package/dist/slash-befehle.js +1 -0
- package/dist/texte/coach.js +27 -0
- package/dist/texte/einrichten-marken.js +2 -2
- package/dist/texte/einrichten.js +58 -5
- package/dist/texte/kurs.js +21 -0
- package/dist/texte/zeigen.js +189 -0
- package/dist/zeigen-rechnung.js +226 -0
- package/dist/zeigen-umgebung.js +190 -0
- package/package.json +3 -1
- package/skill/SKILL.md +10 -5
- package/skill/commands/k3.md +4 -3
- package/skill/commands/k3feierabend.md +2 -3
- package/skill/commands/k3kurs.md +27 -39
- package/skill/commands/k3start.md +4 -3
- package/skill/commands/k3zeigen.md +303 -0
- package/skill/en/SKILL.md +10 -5
- package/skill/en/commands/k3.md +4 -3
- package/skill/en/commands/k3course.md +27 -40
- package/skill/en/commands/k3show.md +302 -0
- package/skill/en/commands/k3start.md +4 -3
- package/skill/en/commands/k3wrapup.md +3 -4
- package/zeigen/gemeinsam.py +82 -0
- package/zeigen/starter.py +163 -0
- package/zeigen/werkzeug.py +250 -0
- package/zeigen/zeitleiste.py +393 -0
package/skill/SKILL.md
CHANGED
|
@@ -13,7 +13,7 @@ description: Projekte ins kimal3-Erfolgsprofil eintragen oder auflisten, Firmend
|
|
|
13
13
|
Sobald der Mensch sagt, ein Projekt sei fertig, oder ausdrücklich bittet, es einzutragen.
|
|
14
14
|
**Oder** wenn er seinen KI-Arbeitsplatz anlegen will — dann s. „Den Arbeitsplatz anlegen".
|
|
15
15
|
|
|
16
|
-
## Die
|
|
16
|
+
## Die neun Slash-Befehle, die der Mensch hat
|
|
17
17
|
|
|
18
18
|
`kimal3 skill install` legt sie global ab (`~/.claude/commands/`) — er kann sie also in
|
|
19
19
|
**jedem** Ordner tippen. Sie sind der Weg, den er selbst auslöst; dieses Skill ist der Weg,
|
|
@@ -24,11 +24,12 @@ den du erkennst.
|
|
|
24
24
|
| `/k3` | Wo er steht — und alle kimal3-Befehle auf einen Blick |
|
|
25
25
|
| `/k3start` | Sitzung starten: wo das Projekt steht und was als Nächstes dran ist |
|
|
26
26
|
| `/k3feierabend` | Sitzung sauber beenden: Stand sichern, aufräumen, zusammenfassen |
|
|
27
|
-
| `/k3kurs` | Zurück in den Mini-Kurs — da weiter, wo er aufgehört hat |
|
|
27
|
+
| `/k3kurs` | Zurück in den Mini-Kurs — holt den Stand mit `kimal3 kurs` und macht da weiter, wo er aufgehört hat |
|
|
28
28
|
| `/k3projekt` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
|
|
29
29
|
| `/k3liste` | Seine eingetragenen Projekte zeigen |
|
|
30
30
|
| `/k3analyse` | Firmendaten holen und seine Frage dazu beantworten |
|
|
31
31
|
| `/k3kontext` | Die offenen Fragen über seine Firma im Gespräch beantworten |
|
|
32
|
+
| `/k3zeigen` | Eine Aufgabe vormachen statt beschreiben — nimmt mit `kimal3 zeigen …` auf, wertet auf dem Rechner aus und schreibt den Plan; gelesen wird erst nach seinem Ja |
|
|
32
33
|
|
|
33
34
|
🔴 **Nenne einen dieser Befehle nur, wenn du weißt, dass er ihn hat.** Sie kommen mit
|
|
34
35
|
`kimal3 skill install`; wer das nie ausgeführt hat, sieht beim Tippen nichts, und ein Rat ins
|
|
@@ -37,7 +38,7 @@ einen Befehl zu zeigen.
|
|
|
37
38
|
|
|
38
39
|
⚠️ **`/k3start`, `/k3feierabend` und `/k3kurs` kamen bis 0.2.4 NUR im Kursordner mit** — Pro-
|
|
39
40
|
Kunden ohne Mini-Kurs hatten sie nie, und aktualisieren ließen sie sich gar nicht. Seit 0.2.5
|
|
40
|
-
liefert das Programm alle
|
|
41
|
+
liefert das Programm sie alle aus. *Triffst du jemanden mit einer älteren Fassung, ist ein
|
|
41
42
|
fehlender Befehl dort kein Fehler, sondern der alte Stand.*
|
|
42
43
|
|
|
43
44
|
## 🔴 Mehrere Firmen: DU WÄHLST NICHT
|
|
@@ -158,8 +159,7 @@ gemeinsam ausfüllen — es sind vier verschiedene. Such nach eckigen Klammern,
|
|
|
158
159
|
zu folgen: Eine abgetippte Liste veraltet in dem Moment, in dem die Vorlage wächst. Frag nach,
|
|
159
160
|
statt zu raten.
|
|
160
161
|
|
|
161
|
-
⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein.
|
|
162
|
-
`[DATUM]` ebenso. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
|
|
162
|
+
⚠️ `[FIRMA]` findest du meist schon ausgefüllt — den Namen setzt der Server beim Ausliefern ein. Was übrig bleibt, sind die Angaben über den **Menschen** vor dir.
|
|
163
163
|
|
|
164
164
|
🔴 **Nur in der Werkbank — nirgends sonst.** Die oberste `CLAUDE.md` und alles in `kontext/` (in einer englischen Firma `context/`)
|
|
165
165
|
gehören der **Firma**, nicht dem Menschen vor dir. Den Firmennamen setzt der Server beim
|
|
@@ -360,6 +360,11 @@ mitbestimmungspflichtig. Das entscheidet die Firma, nicht dieses Werkzeug.
|
|
|
360
360
|
- „Was würdest du als Geschäftsführung als Nächstes automatisieren, gemessen an dem, was bisher
|
|
361
361
|
funktioniert hat — und was davon lässt sich auf andere Abteilungen übertragen?"
|
|
362
362
|
|
|
363
|
+
## Kursstand lesen (`kimal3 kurs`)
|
|
364
|
+
Zeigt, wo der Mensch im Mini-Kurs steht: eine Zeile je Beat, `Als Nächstes:` mit dem nächsten Schritt und dahinter, wer
|
|
365
|
+
ihn abhakt — „(du hakst ab)" oder „(setzt Claude)". Rückgabewert `2` heißt nicht angemeldet, `3` nicht erreichbar —
|
|
366
|
+
dann **keinen Kurs aus dem Gedächtnis erzählen**. Der Slash-Befehl `/k3kurs` führt dadurch.
|
|
367
|
+
|
|
363
368
|
## Rückgabewerte
|
|
364
369
|
`0` erledigt · `1` **Wiederholen hilft nicht — LIES DIE MELDUNG** · `2` Anmeldung fehlt ·
|
|
365
370
|
`3` vorübergehende Störung, einmal wiederholen · `4` angemeldet, aber kein Pro-Zugang —
|
package/skill/commands/k3.md
CHANGED
|
@@ -83,17 +83,18 @@ Stell die Liste in zwei Gruppen dar:
|
|
|
83
83
|
| `/k3projekt <was du gebaut hast>` | Ein fertiges Projekt ins Erfolgsprofil eintragen |
|
|
84
84
|
| `/k3liste` | Deine eingetragenen Projekte zeigen |
|
|
85
85
|
| `/k3analyse <deine Frage>` | Firmendaten holen und deine Frage dazu beantworten |
|
|
86
|
+
| `/k3zeigen` | Eine Aufgabe vormachen statt beschreiben — ich nehme auf und mache daraus einen Plan |
|
|
86
87
|
|
|
87
88
|
Sag dazu: Die Slash-Befehle sind der **sichere** Weg — du musst dir keinen Satz merken. Ohne
|
|
88
89
|
sie geht es auch: „das Projekt ist fertig" genügt, dann greife ich über den Skill.
|
|
89
90
|
|
|
90
|
-
## 6. Der
|
|
91
|
+
## 6. Der zehnte Eintrag im Menü: `/kimal3` ist KEIN Befehl
|
|
91
92
|
|
|
92
93
|
In derselben `/`-Liste steht auch **`/kimal3`**. Erklär den Unterschied **ungefragt** — das Menü
|
|
93
94
|
wirft zwei verschiedene Sorten in eine Liste, und genau daran hat sich der erste Mensch gestoßen,
|
|
94
95
|
der die Familie gesehen hat (Dennis, 2026-08-19):
|
|
95
96
|
|
|
96
|
-
- Die
|
|
97
|
+
- Die neun **`/k3…`** sind **Slash-Befehle** (Dateien in `~/.claude/commands/`) — **der Mensch**
|
|
97
98
|
tippt sie bewusst.
|
|
98
99
|
- **`/kimal3`** ist der **Skill** (`~/.claude/skills/kimal3/SKILL.md`) — meine
|
|
99
100
|
Bedienungsanleitung. Sie ist der Grund, warum „das Projekt ist fertig" genügt: Ich schlage sie
|
|
@@ -101,5 +102,5 @@ der die Familie gesehen hat (Dennis, 2026-08-19):
|
|
|
101
102
|
sie mehrere Dinge auf einmal und liest sich nicht wie ein Menüpunkt.
|
|
102
103
|
|
|
103
104
|
Sag auch, was `/kimal3` **nicht** ist: **nicht die Installation.** Die ist `kimal3 skill install`
|
|
104
|
-
im Terminal — der eine Befehl, der beides ablegt, den Skill **und** die
|
|
105
|
+
im Terminal — der eine Befehl, der beides ablegt, den Skill **und** die neun `/k3…`. Was im Menü
|
|
105
106
|
steht, ist sein Ergebnis.
|
|
@@ -24,10 +24,9 @@ Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den n
|
|
|
24
24
|
taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
|
|
25
25
|
also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
|
|
26
26
|
|
|
27
|
-
**
|
|
27
|
+
**Wo der Statuszettel liegt und wie er heißt.** Die Projektregel gilt **nur innerhalb eines Arbeitsplatzes**: Liegt ein Ordner `projekte/` oder `projects/` direkt in einem Ordner `werkbank-…` oder `workbench-…` (beide Schreibweisen kommen vor, auch gemischt) und steht die Sitzung in oder unter einem Ordner darin, ist dieser **Projektordner** der Ort. Name dort: unter `projekte/` `WEITER-HIER.md`, unter `projects/` `NEXT-STEPS.md`. **Überall sonst** (Starter-Paket, eigene Repos, auch ein Ordner `~/projects/mein-repo`) bleibt es wie bisher: Der Zettel liegt im Startordner, liegt einer da, nimm ihn; muss einer neu entstehen, heißt er `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. **Welcher gilt (im Arbeitsplatz):** Hat das Projekt einen, gilt der des Projekts. Sonst gilt ein vorhandener Werkbank-Zettel (`werkbank-…/WEITER-HIER.md` oder `workbench-…/NEXT-STEPS.md` aus der alten Vorlage) — den liest und pflegst du weiter. Gibt es keinen von beiden, entsteht er **im Projekt**. **Leg nie einen neuen Zettel in der Werkbank an.**
|
|
28
28
|
|
|
29
|
-
Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus
|
|
30
|
-
dann weiter mit Schritt 3.
|
|
29
|
+
**Im Arbeitsplatz** schreibst du in den Zettel des Projekts, an dem heute gearbeitet wurde — fehlt er und liegt auch kein Werkbank-Zettel, leg ihn im Projekt an. **Nach einer reinen Profil-Sitzung** („Wer hier arbeitet“ ausgefüllt, noch kein Projekt) schreibst du **keinen** Zettel, sondern sagst, dass es beim nächsten Mal mit „Erste Sitzung“ in der Werkbank-`CLAUDE.md` weitergeht — dann weiter mit Schritt 3. **Außerhalb eines Arbeitsplatzes** gilt wie bisher: Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus, schlag eine vor, dann weiter mit Schritt 3.
|
|
31
30
|
|
|
32
31
|
1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
|
|
33
32
|
2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
|
package/skill/commands/k3kurs.md
CHANGED
|
@@ -8,46 +8,34 @@ description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
|
|
|
8
8
|
# Kurs
|
|
9
9
|
|
|
10
10
|
> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
|
|
11
|
-
>
|
|
12
|
-
>
|
|
11
|
+
> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
|
|
12
|
+
> https://app.kimal3.de/kurs sieht.
|
|
13
13
|
|
|
14
14
|
Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
|
|
15
15
|
nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
|
|
16
16
|
|
|
17
|
-
## 1. Den
|
|
18
|
-
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
## 5. Nach Beat 2: den Umzug bauen & übergeben
|
|
43
|
-
- Der Abschluss von Beat 2 ist der **Umzug**: Schlag Ordnername + Ort fürs erste echte
|
|
44
|
-
Projekt vor (z. B. `Documents\Claude-Projekte\mein-erstes-projekt` — der echte Ordner heißt im Dateisystem `Documents`, auch wenn der Explorer ihn als Dokumente anzeigt; lass ihn den Ordner einmal im Explorer öffnen, bevor er Claude schließt), leg den Ordner an
|
|
45
|
-
und hinterlege dort eine kurze **`WEITER-HIER.md`** (liegt dort schon ein `NEXT-STEPS.md`, nimm den) als Übergabe-Notiz — was geschafft
|
|
46
|
-
ist und was als Nächstes dran ist (kleine echte Aufgabe wählen, `git init` + erster
|
|
47
|
-
Commit, Rhythmus: durchdenken → bauen → prüfen → sichern, sichtbares Ergebnis; Schritte
|
|
48
|
-
nebenbei im Kurs im Browser abhaken). Dann bitte ihn, Claude ganz zu schließen und im
|
|
49
|
-
neuen Ordner neu zu öffnen (`/k3start`).
|
|
50
|
-
- **Beat 3 führst du nicht von hier aus.** Im neuen Ordner bist du einfach sein Coach —
|
|
51
|
-
die Notiz sagt dir, wo ihr steht. Gefeiert wird im Browser.
|
|
52
|
-
- Ist er schon so weit (oder gar durch), sag das kurz und freundlich — und frag mit einem
|
|
53
|
-
Vorschlag, woran er hier stattdessen arbeiten möchte. Kein Kurs-Gerede mehr.
|
|
17
|
+
## 1. Den Stand holen
|
|
18
|
+
- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
|
|
19
|
+
- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
|
|
20
|
+
und nenn **keinen** Kursstand.
|
|
21
|
+
- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
|
|
22
|
+
Gedächtnis**.
|
|
23
|
+
- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
|
|
24
|
+
|
|
25
|
+
## 2. Stand in einem Satz sagen
|
|
26
|
+
- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
|
|
27
|
+
|
|
28
|
+
## 3. Als Nächstes führen
|
|
29
|
+
- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
|
|
30
|
+
verstehen. Nie die ganze Liste auf einmal.
|
|
31
|
+
- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
|
|
32
|
+
beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
|
|
33
|
+
den Schritt unter https://app.kimal3.de/kurs abzuhaken.
|
|
34
|
+
- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
|
|
35
|
+
`https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
|
|
36
|
+
`kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
|
|
37
|
+
keinen dritten Lauf vor.
|
|
38
|
+
|
|
39
|
+
## 4. Abgeschlossen
|
|
40
|
+
- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
|
|
41
|
+
möchte. Kein Kurs-Gerede mehr.
|
|
@@ -23,11 +23,12 @@ nicht relevant, sag das kurz und überspring ihn — kein Leerlauf.
|
|
|
23
23
|
dich für genau dieses Projekt und hat **Vorrang** vor allem, was hier unten steht.
|
|
24
24
|
- Gibt es ein Status-Doc (`WEITER-HIER.md` oder `ROADMAP.md`) — eine kleine Datei, in der der
|
|
25
25
|
letzte Stand und der nächste Schritt festgehalten sind? Dann lies es.
|
|
26
|
-
- **
|
|
27
|
-
-
|
|
26
|
+
- **Wo der Statuszettel liegt und wie er heißt.** Die Projektregel gilt **nur innerhalb eines Arbeitsplatzes**: Liegt ein Ordner `projekte/` oder `projects/` direkt in einem Ordner `werkbank-…` oder `workbench-…` (beide Schreibweisen kommen vor, auch gemischt) und steht die Sitzung in oder unter einem Ordner darin, ist dieser **Projektordner** der Ort. Name dort: unter `projekte/` `WEITER-HIER.md`, unter `projects/` `NEXT-STEPS.md`. **Überall sonst** (Starter-Paket, eigene Repos, auch ein Ordner `~/projects/mein-repo`) bleibt es wie bisher: Der Zettel liegt im Startordner, liegt einer da, nimm ihn; muss einer neu entstehen, heißt er `WEITER-HIER.md` — oder `NEXT-STEPS.md`, wenn der Ordner englisch angelegt wurde. Liegen beide da, frag, welcher gilt, und schreib in keinen, bevor die Antwort da ist. **Welcher gilt (im Arbeitsplatz):** Hat das Projekt einen, gilt der des Projekts. Sonst gilt ein vorhandener Werkbank-Zettel (`werkbank-…/WEITER-HIER.md` oder `workbench-…/NEXT-STEPS.md` aus der alten Vorlage) — den liest und pflegst du weiter. Gibt es keinen von beiden, entsteht er **im Projekt**. **Leg nie einen neuen Zettel in der Werkbank an.**
|
|
27
|
+
- **Stehst du in der Werkbank selbst (`werkbank-…` oder `workbench-…`), nicht in einem Projekt?** Steht in ihrer `CLAUDE.md` der Abschnitt „Erste Sitzung“ (englisch „First session“), folge **ihm** — er hat Vorrang vor allem Folgenden. Steht er nicht (mehr) da, zeig die Projekte in `projekte/` bzw. `projects/` (ohne `beispiel-rechnungen-erfassen` und `example-capture-invoices`) mit je der **ersten Stand-Zeile** ihres Zettels, oder „noch kein Zettel“, wenn keiner da ist; ein vorhandener Werkbank-Zettel (`WEITER-HIER.md` oder `NEXT-STEPS.md`) steht darüber. Empfiehl daraus **eines** und stell **eine** Frage dazu. Wählt der Mensch ein Projekt aus der Liste oder nennt eine neue Aufgabe (dann legst du erst Ordner und Statuszettel im Projekt an, nie in der Werkbank), bring die Sitzung in den Projektordner: mit `change_directory` (steht es nur als Name in deiner Werkzeugliste, lade es über die Werkzeugsuche) — und sag vorher: „Gleich fragt dich die Claude-App, ob ich den Ordner wechseln darf, und danach, ob du ihm vertraust — beides ist richtig so, klick jeweils auf Erlauben. Landest du danach in einem leeren Gespräch, tipp dort `/k3start`; dieses Gespräch findest du links in der Liste wieder.“ Ohne das Werkzeug oder wenn der Mensch ablehnt: nenne den genauen Projektordner (nicht die Werkbank darüber) — in der App „Ordner wählen“ und diesen Ordner nehmen, im Terminal `/exit`, `cd '‹Pfad›'`, `claude` — und dann `/k3start`. Bei einem neuen Projekt lies vorher `projekte/CLAUDE.md` (englisch `projects/CLAUDE.md`): ab jetzt gilt sie.
|
|
28
|
+
- Kein Status-Doc? **Sieh erst nach, ob ein `.git`-Ordner im Zettel-Ort liegt** (im Arbeitsplatz der Projektordner, sonst der Startordner). Wenn ja, führt dieses
|
|
28
29
|
Projekt eine Versionsgeschichte, und `git log --oneline -10` plus `git status` zeigen dir den
|
|
29
30
|
letzten Stand.
|
|
30
|
-
⚠️ **Liegt kein `.git
|
|
31
|
+
⚠️ **Liegt dort kein `.git`, lass beide Befehle weg.** Sie antworten dann mit
|
|
31
32
|
`fatal: not a git repository` — und eine Fehlermeldung als Begrüßung sieht aus, als hätte die
|
|
32
33
|
Person etwas falsch gemacht. Bei einem frisch begonnenen Projekt, in dem noch nichts gesichert
|
|
33
34
|
wurde, scheitert `git log` allein; `git status` läuft dort und meldet „alles sauber".
|
|
@@ -0,0 +1,303 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Eine Aufgabe vormachen statt beschreiben — ich nehme auf und mache daraus einen Plan
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
|
|
6
|
+
jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
|
|
7
|
+
behalten will, kopiert die Datei unter einem anderen Namen. -->
|
|
8
|
+
# Zeigen
|
|
9
|
+
|
|
10
|
+
> Du machst eine Aufgabe einmal am Bildschirm vor und sagst dabei laut, was du tust und warum.
|
|
11
|
+
> Ich nehme das auf, werte es auf deinem Rechner aus und schreibe daraus eine Beschreibung ins
|
|
12
|
+
> Projekt — damit wir die Aufgabe danach automatisieren können, ohne dass du sie erst als
|
|
13
|
+
> Anforderung aufschreiben musst.
|
|
14
|
+
|
|
15
|
+
Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, **eine Frage
|
|
16
|
+
auf einmal und immer mit Vorschlag**, das Warum vor dem Wie, null Vorwissen vorausgesetzt. Das
|
|
17
|
+
Mechanische macht das Programm (`kimal3 zeigen …`), du führst das Gespräch mit dem Menschen. Wie du
|
|
18
|
+
allgemein mit den Rückgabewerten von `kimal3` umgehst, steht in `~/.claude/skills/kimal3/SKILL.md`;
|
|
19
|
+
hier stehen nur die Fälle dieses Befehls.
|
|
20
|
+
|
|
21
|
+
## 🔴 Drei Regeln für das ganze Gespräch
|
|
22
|
+
|
|
23
|
+
1. **Vor dem Ja in Schritt 10 liest du nichts aus der Aufnahme.** Kein `zeitleiste.md`, kein Bild,
|
|
24
|
+
kein Protokoll, keine andere Datei aus `material/aufnahmen/` — und du **suchst** dort auch nicht:
|
|
25
|
+
kein Grep, kein Glob, keine Dateisuche über das Projekt, die diesen Ordner einschließt. Was dort
|
|
26
|
+
liegt, verlässt den Rechner erst mit dem Ja des Menschen. Die Ausgaben von `kimal3 zeigen …`
|
|
27
|
+
darfst du lesen — sie enthalten nur Zahlen, Uhrzeiten und Ordnernamen.
|
|
28
|
+
2. **Nichts installieren, nichts aufnehmen, nichts löschen ohne ein ausdrückliches Ja zu genau
|
|
29
|
+
diesem Schritt.** Eine Datei aus der Aufnahme öffnest du für den Menschen nur in Notepad, und so,
|
|
30
|
+
dass dein Aufruf sofort zurückkommt: in Bash `cmd //c start "" notepad "<pfad>"`, in PowerShell
|
|
31
|
+
`Start-Process notepad -ArgumentList '"<pfad>"'`. Ein nacktes `notepad "<pfad>"` blockiert, bis
|
|
32
|
+
das Fenster wieder zu ist. Nie in einer IDE oder einem Editor, an dem Claude Code hängt (dort
|
|
33
|
+
landen markierte Zeilen von selbst im Gespräch).
|
|
34
|
+
3. **Ein Fehlschlag sieht nie aus wie ein Erfolg.** Endet ein `kimal3 zeigen …` nicht mit `0`,
|
|
35
|
+
sag ehrlich, was seine Meldung sagt, und mach nicht weiter, als hätte es geklappt.
|
|
36
|
+
|
|
37
|
+
Alle `kimal3 zeigen …` laufen **im Projektordner** (Schritt 3) — das Programm findet die Aufnahme
|
|
38
|
+
über den Ordner, in dem es gestartet wird. Liegt eine Aufnahme in einem anderen Projekt, wechselst
|
|
39
|
+
du zuerst dorthin: Der Projektordner ist der Teil des Pfads vor `material/aufnahmen/`.
|
|
40
|
+
|
|
41
|
+
## 1. Ankommen und nachsehen
|
|
42
|
+
|
|
43
|
+
Führe zuerst `kimal3 zeigen status` aus. Es liest nur. Den Block „Eingerichtet:" liest du dem
|
|
44
|
+
Menschen **nicht** vor — du merkst dir nur, ob darin etwas fehlt (eine Zeile mit „fehlt", „nicht
|
|
45
|
+
prüfbar", „kann ich nicht feststellen" oder „(gebraucht wird …)" → Schritt 4).
|
|
46
|
+
|
|
47
|
+
| Die Ausgabe sagt | Was du tust |
|
|
48
|
+
|---|---|
|
|
49
|
+
| `kimal3 zeigen` gibt es bisher nur unter Windows; der Mac folgt. | Sag genau das, freundlich: Vormachen geht auf diesem Rechner noch nicht, der Mac kommt. Biete an, dass der Mensch die Aufgabe stattdessen in Worten beschreibt. Hier endet der Befehl. |
|
|
50
|
+
| „Ob gerade aufgenommen wird, kann ich nicht feststellen." (Rückgabewert 1) | Sag ehrlich, dass du es gerade nicht feststellen kannst. **Starte nichts.** Biete an, in einer Minute noch einmal nachzusehen. |
|
|
51
|
+
| „Läuft seit 09:12 (3 Minuten), Ordner `…`, stoppt spätestens 09:27." | Eine Aufnahme aus einer früheren Sitzung läuft noch. Steht im Ordner ein voller Pfad außerhalb dieses Projekts, wechsle zuerst in dessen Projektordner. Dann frag: „Da läuft noch eine Aufnahme von 09:12 — bist du mit dem Vormachen durch? Dann stoppe ich sie jetzt." Ja → Schritt 8. |
|
|
52
|
+
| „Läuft (in einer anderen Sitzung gestartet)." | Es läuft eine Aufnahme, die dieses Projekt nicht zuordnen kann. Sag das, **starte keine zweite**, und schlag vor, mit `kimal3 zeigen status` nachzusehen, sobald sie zu Ende ist. |
|
|
53
|
+
| „Keine Aufnahme läuft." und darunter „Die letzte (`…`) hat nach 15 Minuten von selbst gestoppt." | Eine Aufnahme ist fertig, aber vermutlich noch nicht ausgewertet. **Starte nicht still eine neue darüber.** Frag mit Vorschlag: „Die Aufnahme von 09:12 hat nach 15 Minuten von selbst aufgehört — soll ich sie auswerten, oder machst du die Aufgabe neu vor? Ich würde sie auswerten; was du nach den 15 Minuten gemacht hast, fehlt dann." Auswerten → Schritt 9 (die Uhrzeit steht im Ordnernamen, `…-0912`). Neu → weiter hier. |
|
|
54
|
+
| „Keine Aufnahme läuft." und darunter „Die letzte (`…`) ist abgebrochen." | Freundlich: Die letzte Aufnahme ist mittendrin abgebrochen — der Mensch hat nichts falsch gemacht. Biete an, die Aufgabe neu vorzumachen. |
|
|
55
|
+
| „Keine Aufnahme läuft." | Weiter. |
|
|
56
|
+
|
|
57
|
+
Die letzte Zeile sagt, ob der Ordner passt — merk sie dir für Schritt 3:
|
|
58
|
+
„Aufnahmen landen hier in: …" (passt) · „Wechsle zuerst in ein Projekt …" (die Sitzung steht in
|
|
59
|
+
der Werkbank) · „Der Projektordner liegt zu tief für den Aufnehmer …" (der Pfad ist zu lang).
|
|
60
|
+
|
|
61
|
+
Steht die Sitzung in der Werkbank, sag **das zuerst**, in einem Satz: Die Aufnahme gehört in ein
|
|
62
|
+
Projekt, und eins schlägst du gleich vor. Dann erklär in höchstens fünf kurzen Sätzen, was
|
|
63
|
+
passiert, und stell **eine** Frage:
|
|
64
|
+
|
|
65
|
+
> „Du machst mir die Aufgabe einmal vor und sprichst dabei. Ich nehme dabei Bildschirm, Ton,
|
|
66
|
+
> Klicks und Tasten auf. Das bleibt auf deinem Rechner. Bevor ich etwas davon lese, frage ich
|
|
67
|
+
> dich. Welche Aufgabe willst du mir zeigen — in einem Satz?"
|
|
68
|
+
|
|
69
|
+
Bis der Mensch geantwortet hat, ist nichts installiert und nichts aufgenommen.
|
|
70
|
+
|
|
71
|
+
## 2. Die Aufgabe in einem Satz
|
|
72
|
+
|
|
73
|
+
Warte auf die Antwort. Den Satz des Menschen übernimmst du **unverändert** — er steht später im
|
|
74
|
+
Kopf der Zeitleiste, und gerade dort, wo er und die Vorführung auseinandergehen, steckt die
|
|
75
|
+
wichtigste Rückfrage (Schritt 11). Ein grober Satz reicht; bohr nicht nach.
|
|
76
|
+
|
|
77
|
+
## 3. Der richtige Ordner
|
|
78
|
+
|
|
79
|
+
- **Aufnahmen landen hier schon richtig?** Weiter mit Schritt 4.
|
|
80
|
+
- **Die Sitzung steht in der Werkbank** (`werkbank-…`): Schlag ein Projekt mit einem kurzen Namen
|
|
81
|
+
aus der Aufgabe vor — Kleinbuchstaben, Bindestriche: „Ich würde dafür das Projekt
|
|
82
|
+
`projekte/angebotsliste` anlegen — passt das?" (heißt der Ordner in der Werkbank `projects/`,
|
|
83
|
+
dann dort). Erst nach dem Ja legst du **nur** `plan/` und `material/` darin an, nichts auf
|
|
84
|
+
Vorrat. Ab jetzt läuft jeder `kimal3 zeigen …` in diesem Projektordner (z. B.
|
|
85
|
+
`cd "<projektordner>" && kimal3 zeigen status`). Sieh mit `kimal3 zeigen status` nach, dass
|
|
86
|
+
die letzte Zeile jetzt „Aufnahmen landen hier in: …" sagt.
|
|
87
|
+
- **Der Pfad ist zu tief:** Nenn die Zahl aus der Meldung und warum (der Aufnehmer scheitert an
|
|
88
|
+
langen Pfaden). Schlag vor, das Projekt näher am Laufwerk anzulegen, und frag, bevor du etwas
|
|
89
|
+
anlegst.
|
|
90
|
+
|
|
91
|
+
## 4. Einrichten — nur wenn etwas fehlt
|
|
92
|
+
|
|
93
|
+
Fehlt nichts, überspring diesen Schritt ohne ein Wort darüber. Fehlt etwas, sag **vorher genau
|
|
94
|
+
das** und warte auf die Antwort:
|
|
95
|
+
|
|
96
|
+
> „Dafür richte ich einmal den Aufnehmer ein — ein freies Programm, das Bildschirm, Ton, Klicks
|
|
97
|
+
> und Tasten aufzeichnet. Etwa 2,1 GB, je nach Leitung 10 bis 20 Minuten, nur in deinem
|
|
98
|
+
> Benutzerordner, ohne Adminrechte. Weil er Tasten mitschreibt, kann der Virenschutz deiner Firma
|
|
99
|
+
> ihn melden; auf einem Firmenrechner frag im Zweifel vorher die IT. Soll ich?"
|
|
100
|
+
|
|
101
|
+
- **Ja:** Starte `kimal3 zeigen einrichten` **im Hintergrund** — es kann länger dauern als die zehn
|
|
102
|
+
Minuten, die ein Befehl im Vordergrund laufen darf. Sag, dass es läuft und der Mensch solange
|
|
103
|
+
etwas anderes tun kann. **Warte auf die Meldung, dass es fertig ist** — frag nicht
|
|
104
|
+
zwischendurch nach, und schlaf nicht in einer Schleife. Danach:
|
|
105
|
+
- Rückgabewert `0` → `kimal3 zeigen status`; stehen alle vier Teile da (uv, Aufnehmer, FFmpeg,
|
|
106
|
+
Sprachmodell), weiter mit Schritt 5.
|
|
107
|
+
- Rückgabewert `1` („Schritt … hat nicht geklappt.") → nenn diesen Schritt und biete eine
|
|
108
|
+
fertige Nachricht an die IT an: **was** (uv von Astral · der Aufnehmer openadapt-capture 1.3.0,
|
|
109
|
+
Lizenz MIT, mit Python 3.12 · FFmpeg · das Sprachmodell large-v3-turbo von Hugging Face),
|
|
110
|
+
**wozu** (eine Arbeitsaufgabe einmal am Bildschirm vorführen und auf dem Rechner auswerten),
|
|
111
|
+
**woher** (astral.sh bzw. winget, pypi.org, huggingface.co), **welche Ordner** (nur der
|
|
112
|
+
Benutzerordner, ohne Adminrechte).
|
|
113
|
+
- **Nein:** „Kein Problem — mit `/k3zeigen` geht es jederzeit später." Hier endet der Befehl.
|
|
114
|
+
|
|
115
|
+
## 5. Die Ansage vor dem Start
|
|
116
|
+
|
|
117
|
+
Sag diese vier Punkte, bevor irgendetwas aufnimmt:
|
|
118
|
+
|
|
119
|
+
1. Aufgenommen werden **alle Bildschirme**. Schließ, was fremde Daten zeigt, schalte „Nicht
|
|
120
|
+
stören" ein, und nicht während eines Anrufs. Wenn es geht, nimm einen **Testkunden** statt
|
|
121
|
+
eines echten.
|
|
122
|
+
2. **Tippe kein Passwort** — jede Taste wird mitgeschrieben.
|
|
123
|
+
3. Sprich laut, **warum** du etwas tust.
|
|
124
|
+
4. Wenn du fertig bist, komm hierher zurück und schreib **„fertig"**; spätestens nach 15 Minuten
|
|
125
|
+
stoppt die Aufnahme von selbst.
|
|
126
|
+
|
|
127
|
+
Dann: „Schreib ‚los‘, wenn alles bereit ist." — und warte.
|
|
128
|
+
|
|
129
|
+
- **Ein klares Startsignal** — „los", „bereit", „kann losgehen", „start" — → Schritt 6.
|
|
130
|
+
- **Ein bloßes „ok" oder „ja"** → frag einmal: „Soll ich jetzt starten?"
|
|
131
|
+
- **Etwas anderes** → antworte und sag, dass es mit „los" losgeht.
|
|
132
|
+
|
|
133
|
+
**Vor dem Startsignal startet nichts.**
|
|
134
|
+
|
|
135
|
+
## 6. Starten
|
|
136
|
+
|
|
137
|
+
Nach dem Startsignal: `kimal3 zeigen start '<Satz des Menschen>'`. Übergib den Satz als **ein**
|
|
138
|
+
Argument, so dass die Shell nichts daran ändert — in Bash in einfachen Anführungszeichen (ein `'`
|
|
139
|
+
darin als `'\''`), in PowerShell in einfachen Anführungszeichen (ein `'` darin verdoppelt).
|
|
140
|
+
`--hoechstens` (1 bis 15 Minuten) nur, wenn der Mensch ausdrücklich kürzer will.
|
|
141
|
+
|
|
142
|
+
| Die Ausgabe sagt | Was du tust |
|
|
143
|
+
|---|---|
|
|
144
|
+
| „Die Aufnahme läuft (Ordner …), stoppt spätestens um …" (Rückgabewert 0) | Sag genau: „Läuft. Mach vor — und schreib hier ‚fertig‘, wenn du durch bist." **Dann beende deinen Zug** — kein weiterer Befehl, kein Nachsehen. |
|
|
145
|
+
| „Es läuft schon eine Aufnahme (seit 09:12, Ordner `…`)." · „Gerade startet schon eine Aufnahme …" | Es entsteht keine zweite. Frag: „Da läuft noch eine Aufnahme von 09:12 — soll ich sie stoppen, damit wir neu anfangen?" Ja → `kimal3 zeigen stopp` (Schritt 8), danach zurück zu Schritt 5. |
|
|
146
|
+
| „Es läuft schon eine Aufnahme (in einer anderen Sitzung gestartet)." | Frag: „Da läuft noch eine Aufnahme aus einer anderen Sitzung — soll ich sie stoppen, damit wir neu anfangen?" Ja → `kimal3 zeigen stopp`; sagt es, dass es sie hier nicht zuordnen kann, sag das ehrlich und schlag vor, zu warten, bis sie von selbst aufhört (`kimal3 zeigen status`). |
|
|
147
|
+
| „Ob gerade aufgenommen wird, kann ich nicht feststellen — deshalb starte ich keine zweite." | Ehrlich sagen, nichts erzwingen, später noch einmal nachsehen. |
|
|
148
|
+
| „Der Aufnehmer ist noch nicht eingerichtet: `kimal3 zeigen einrichten`." | Zurück zu Schritt 4. |
|
|
149
|
+
| „Die Aufnahme ist nicht gestartet: <Grund>. Protokoll: …" | Nenn den Grund. **Öffne das Protokoll nicht** — darin stehen Fenstertitel. Folgt „Ob der Aufnehmer noch läuft, sagt `kimal3 zeigen status`.", führ `kimal3 zeigen status` aus und sag, was es meldet. Biete einen neuen Versuch an. |
|
|
150
|
+
| „Wechsle zuerst in ein Projekt …" · „Der Projektordner liegt zu tief …" | Zurück zu Schritt 3. |
|
|
151
|
+
|
|
152
|
+
## 7. Während der Aufnahme
|
|
153
|
+
|
|
154
|
+
Schreibt der Mensch etwas anderes als „fertig" (eine Frage, einen Gedanken), antworte kurz und
|
|
155
|
+
schließ mit: „Die Aufnahme läuft noch — schreib ‚fertig‘, wenn du durch bist." Öffne dabei nichts
|
|
156
|
+
auf dem Bildschirm (es landete im Video) und stoppe die Aufnahme nicht von dir aus.
|
|
157
|
+
„fertig", „bin durch", „done" und Ähnliches → Schritt 8.
|
|
158
|
+
|
|
159
|
+
## 8. Stoppen
|
|
160
|
+
|
|
161
|
+
Sag zuerst: „Ich schließe die Aufnahme ab — das kann eine Minute dauern, bei einer langen Aufnahme
|
|
162
|
+
auch mehrere." Während des Abschließens sieht der Mensch sonst nichts passieren.
|
|
163
|
+
|
|
164
|
+
Dann `kimal3 zeigen stopp` — mit der **längsten Wartezeit, die das Werkzeug erlaubt (10 Minuten)**: Der
|
|
165
|
+
Aufnehmer schließt dabei das Video ab, und bei einer langen Aufnahme dauert das; mit der
|
|
166
|
+
Voreinstellung von 2 Minuten bräche der Aufruf mittendrin ab. Das Programm antwortet spätestens nach
|
|
167
|
+
gut 8 Minuten, also bevor die 10 Minuten um sind.
|
|
168
|
+
|
|
169
|
+
| Die Ausgabe sagt | Was du tust |
|
|
170
|
+
|---|---|
|
|
171
|
+
| „Aufnahme gestoppt: 1:33 Minuten, 30 Klicks, 49 Tasten, Ton ist da." | Die Zahlen in einem Satz wiederholen, weiter mit Schritt 9. |
|
|
172
|
+
| „Die Aufnahme wird noch abgeschlossen — gleich noch einmal `kimal3 zeigen stopp`." (Rückgabewert 1) | Sag: „Der Aufnehmer schließt die Aufnahme noch ab — ich frag gleich noch einmal nach." Dann `kimal3 zeigen stopp` noch einmal, wieder mit 10 Minuten Wartezeit. **Nie** „nicht sauber" und keine neue Aufnahme anbieten. |
|
|
173
|
+
| „Die Aufnahme hat nach 15 Minuten von selbst gestoppt: …" (Rückgabewert 0) | Sag: „Die Aufnahme hat nach 15 Minuten von selbst aufgehört — was du danach gemacht hast, ist nicht drin." Weiter mit Schritt 9. |
|
|
174
|
+
| „Es läuft keine Aufnahme." | Sieh mit `kimal3 zeigen status` nach. Steht dort „Die letzte (`…`) hat nach … Minuten von selbst gestoppt.", geht es mit Schritt 9 weiter; sonst sag ehrlich, dass keine Aufnahme da ist. |
|
|
175
|
+
| „Ob gerade aufgenommen wird, kann ich nicht feststellen." | Ehrlich sagen — **nie** „gestoppt". Biete an, in einer Minute mit `kimal3 zeigen status` noch einmal nachzusehen. |
|
|
176
|
+
| „Die Aufnahme ist nicht sauber abgeschlossen: <Grund>." (Rückgabewert 1) | Nenn den Grund und biete eine neue Aufnahme an. |
|
|
177
|
+
| „Die Aufnahme ist abgebrochen: <Grund>. …" (Rückgabewert 1) | Freundlich: Der Mensch hat nichts falsch gemacht. Nenn den Grund und biete eine neue Aufnahme an. |
|
|
178
|
+
| „Die Aufnahme ließ sich nicht stoppen …" · „Es läuft eine Aufnahme, die ich hier nicht zuordnen kann …" | `kimal3 zeigen status` ausführen und ehrlich sagen, was es meldet — **nie** „gestoppt". Läuft die Sitzung im falschen Ordner, wechsle in das Projekt der Aufnahme. |
|
|
179
|
+
|
|
180
|
+
## 9. Auswerten — auf dem Rechner des Menschen
|
|
181
|
+
|
|
182
|
+
`kimal3 zeigen auswerten` (ohne Ordner nimmt es die jüngste Aufnahme des Projekts; die Sprache
|
|
183
|
+
der Erkennung folgt dem Konto — `--sprache en` oder `--sprache de` nur, wenn der Mensch in der
|
|
184
|
+
anderen Sprache gesprochen hat). Das dauert etwa so lange wie die Aufnahme:
|
|
185
|
+
|
|
186
|
+
- **Aufnahme bis etwa 3 Minuten:** im Vordergrund, mit der längsten Wartezeit (10 Minuten).
|
|
187
|
+
- **Länger — und immer, wenn sie nach 15 Minuten von selbst aufgehört hat:** **im Hintergrund**,
|
|
188
|
+
wie beim Einrichten. Sag, dass es etwa so lange dauert wie die Aufnahme, und **warte auf die
|
|
189
|
+
Meldung, dass es fertig ist** — kein Nachfragen zwischendurch, keine Schleife.
|
|
190
|
+
|
|
191
|
+
| Die Ausgabe sagt | Was du tust |
|
|
192
|
+
|---|---|
|
|
193
|
+
| „Zeitleiste fertig: … Datei: `…`." | Die Zahlen in einem Satz sagen. Den Pfad merken — **die Datei nicht öffnen**. Weiter mit Schritt 10. |
|
|
194
|
+
| „Ich habe keine Sprache erkannt — war das Mikrofon stumm oder das falsche gewählt?" | Genau das fragen und eine neue Aufnahme anbieten. |
|
|
195
|
+
| „Die Aufnahme hat keine Tonspur — ohne Ton entsteht keine Zeitleiste. Eine neue Aufnahme hilft." | Eine neue Aufnahme anbieten. |
|
|
196
|
+
| „In diesem Projekt finde ich keine Aufnahme (`material/aufnahmen/`)." | Die Sitzung steht nicht im Projekt der Aufnahme: Wechsle dorthin (der Teil des Pfads vor `material/aufnahmen/`, aus `kimal3 zeigen status` oder der Stopp-Meldung) und werte noch einmal aus. |
|
|
197
|
+
| „Den Aufnahmeordner gibt es nicht: …" | Sag ehrlich, dass die Aufnahme dort nicht (mehr) liegt. Mit `kimal3 zeigen status` nachsehen; sonst eine neue Aufnahme anbieten. |
|
|
198
|
+
| „Der Aufnehmer ist noch nicht eingerichtet: `kimal3 zeigen einrichten`." | Zurück zu Schritt 4, danach noch einmal auswerten. |
|
|
199
|
+
| „Die Zeitleiste ist nicht entstanden: <Grund>." | Nenn den Grund; fehlt das Sprachmodell, zurück zu Schritt 4. |
|
|
200
|
+
| „Die Aufnahme läuft noch — erst `kimal3 zeigen stopp`." | Zurück zu Schritt 8. |
|
|
201
|
+
|
|
202
|
+
## 10. Datenschutz — bevor du liest
|
|
203
|
+
|
|
204
|
+
Zuerst eine Frage, und warte auf die Antwort:
|
|
205
|
+
|
|
206
|
+
> „Waren in der Vorführung echte Daten von Menschen zu sehen — Kundennamen, Mailadressen?"
|
|
207
|
+
|
|
208
|
+
**Ja:** Dann gehen die vier Fragen aus `kontext/sicherheit.md` (im Arbeitsplatz über der Werkbank)
|
|
209
|
+
**jetzt**, vor dem Lesen — einzeln, jede mit Vorschlag: welche Felder · wohin (an Anthropic, die
|
|
210
|
+
Firma hinter Claude, Rechenzentren in den USA) · auf welcher Grundlage · geht es sparsamer, z. B.
|
|
211
|
+
noch einmal mit Testkunden. Die Antworten schreibst du nach `ergebnisse/datenschutz-vorfuehrung.md`.
|
|
212
|
+
Ist die Antwort „noch einmal mit Testkunden", lies nichts, schlag vor, diese Aufnahme zu löschen
|
|
213
|
+
(Schritt 13, Satz **ohne** Plan), und fang bei Schritt 5 neu an.
|
|
214
|
+
|
|
215
|
+
Dann diese Frage, wörtlich:
|
|
216
|
+
|
|
217
|
+
> „Damit ich die Zeitleiste lesen kann, geht sie an Anthropic: was du gesagt hast, wohin du
|
|
218
|
+
> geklickt hast (mit den Namen der Knöpfe und Felder, darin können Namen stehen) und was du
|
|
219
|
+
> getippt hast. Bildschirmfotos zeigen deinen ganzen Bildschirm — die schaue ich mir nur an, wo
|
|
220
|
+
> der Text nicht reicht, und frage dich vor jedem einzeln. Soll ich die Datei für dich öffnen,
|
|
221
|
+
> damit du vorher hineinsehen kannst? Einverstanden — oder lieber ohne die getippten Stellen?"
|
|
222
|
+
|
|
223
|
+
- **„Öffnen":** in Notepad, wie in Regel 2 (`cmd //c start "" notepad "<voller pfad>"` bzw.
|
|
224
|
+
`Start-Process`), mit dem vollen Pfad zur `zeitleiste.md` (Projektordner plus der Pfad aus
|
|
225
|
+
Schritt 9). Der Mensch liest selbst; du liest nicht mit. Danach dieselbe Frage nach dem
|
|
226
|
+
Einverständnis noch einmal.
|
|
227
|
+
- **„Ohne die getippten Stellen":** `kimal3 zeigen auswerten --ohne-getipptes` — mit demselben
|
|
228
|
+
`--sprache` wie beim ersten Mal, falls du eins gesetzt hattest, und mit derselben Wartezeit-Regel
|
|
229
|
+
wie in Schritt 9. Die Zeitleiste wird neu geschrieben, Getipptes steht dann als
|
|
230
|
+
„[getippt, ausgelassen]". Der Mensch hat damit dieser Fassung zugestimmt → Schritt 11.
|
|
231
|
+
- **Einverstanden:** → Schritt 11.
|
|
232
|
+
- **Nein:** Lies nichts. Sag: „Du kannst die Datei selbst lesen und mir die Aufgabe beschreiben —
|
|
233
|
+
oder ich lösche die Aufnahme."
|
|
234
|
+
- **Beschreibt der Mensch selbst:** Nimm seine Beschreibung, frag wie in Schritt 11, Punkt 4,
|
|
235
|
+
nach (eine Frage auf einmal), und weiter mit Schritt 12 — Plan und Bauweg **aus der
|
|
236
|
+
Beschreibung**, ohne etwas aus der Aufnahme zu lesen. Danach Schritt 13.
|
|
237
|
+
- **Löschen:** Schritt 13, Satz **ohne** Plan.
|
|
238
|
+
|
|
239
|
+
## 11. Lesen, zurückerzählen, nachfragen
|
|
240
|
+
|
|
241
|
+
Jetzt — und erst jetzt — liest du `zeitleiste.md`, und nur diese Datei.
|
|
242
|
+
|
|
243
|
+
1. **Erzähl die Aufgabe zurück:** in nummerierten Schritten, in den **Worten des Menschen** (zitier,
|
|
244
|
+
was gesagt wurde), je Schritt mit dem Zeitpunkt aus der Zeitleiste (`0:26`).
|
|
245
|
+
2. **Such die Widersprüche, ausdrücklich.** Drei Quellen sagen etwas über die Aufgabe: der
|
|
246
|
+
Aufgabensatz im Kopf der Zeitleiste, was der Mensch **sagt**, und was er **anklickt und tippt**.
|
|
247
|
+
Geh den Aufgabensatz Teil für Teil durch (was, wohin, an wen, wann) und frag bei jedem Teil:
|
|
248
|
+
Zeigt die Vorführung genau das? Dann jeden gesprochenen Satz gegen den Klick daneben. Jede
|
|
249
|
+
Stelle, an der zwei Quellen auseinandergehen, nennst du im Zurückerzählen mit ⚠️ — zum Beispiel:
|
|
250
|
+
„Du hast auf ‚morgen‘ geklickt, aber gesagt ‚für den aktuellen Tag‘ — was gilt?" oder „Im
|
|
251
|
+
Aufgabensatz steht ‚in einen Channel‘, vorgemacht hast du eine Direktnachricht — was gilt?"
|
|
252
|
+
*Genau diese Stellen sind der Grund, warum Vormachen mehr verrät als Beschreiben.*
|
|
253
|
+
3. **Bildschirmfotos nur einzeln und nur gefragt.** Reicht der Text an einer Stelle nicht (ein
|
|
254
|
+
Klick ohne Namen, ein Satz, der auf etwas Sichtbares zeigt), frag vorher: „Bei 0:26 sagt der
|
|
255
|
+
Text nur ‚…‘. Darf ich mir den Bildschirm an der Stelle ansehen?" Ja → `kimal3 zeigen bild 0:26`;
|
|
256
|
+
es meldet „Bild: <pfad>", und du siehst dir **nur dieses eine** Bild an. Nein → frag, was dort
|
|
257
|
+
zu sehen war.
|
|
258
|
+
4. **Dann fragen — eine Frage auf einmal, immer mit Vorschlag:** zuerst die Widersprüche, einer
|
|
259
|
+
nach dem anderen. Danach, was eine einzige Vorführung nie zeigen kann: **wie oft und wann**
|
|
260
|
+
(„Ich vermute jeden Montag früh — stimmt das?") · **was bei einer Ausnahme passiert**
|
|
261
|
+
(Feiertag, leere Liste, das System ist nicht erreichbar) · **an wen das Ergebnis geht**.
|
|
262
|
+
|
|
263
|
+
## 12. In den Plan schreiben und einen Bauweg vorschlagen
|
|
264
|
+
|
|
265
|
+
Schreib `plan/aufgabe-vorgefuehrt.md` mit diesen Teilen:
|
|
266
|
+
|
|
267
|
+
- **Ziel** in einem Satz
|
|
268
|
+
- **Die Schritte**, nummeriert
|
|
269
|
+
- **Regeln und Ausnahmen** aus den Antworten
|
|
270
|
+
- **Was offen ist**
|
|
271
|
+
- **Woher es stammt:** Vorführung vom <Datum> (oder: Beschreibung vom <Datum>, wenn nichts gelesen
|
|
272
|
+
wurde)
|
|
273
|
+
|
|
274
|
+
Der Plan trägt den Inhalt **selbst** und verweist nicht auf Dateien in der Aufnahme — die soll
|
|
275
|
+
gleich weg. Getipptes, das nach Zugangsdaten aussieht, kommt nicht hinein.
|
|
276
|
+
|
|
277
|
+
Dann sag, wie du es **bauen würdest**: über die Schnittstellen der Programme (die Daten direkt
|
|
278
|
+
holen, die Nachricht direkt schicken), **nicht** durch Nachklicken der Klicks — so bricht es
|
|
279
|
+
nicht, wenn sich eine Oberfläche ändert. Gebaut wird nicht hier; das ist der nächste Schritt im
|
|
280
|
+
Projekt, gern gleich oder in der nächsten Sitzung mit `/k3start`.
|
|
281
|
+
|
|
282
|
+
## 13. Die Aufnahme löschen — nur nach Ja
|
|
283
|
+
|
|
284
|
+
Miss die Größe des Aufnahmeordners und schlag vor, mit den echten Werten. Steht die Aufgabe im
|
|
285
|
+
Plan (Schritt 12):
|
|
286
|
+
|
|
287
|
+
> „Die Aufnahme ist 12,9 MB groß und liegt in `material/aufnahmen/2026-10-19-0912`. Ich würde sie
|
|
288
|
+
> löschen — die Beschreibung steht im Plan, und in der Aufnahme steckt alles, was du getippt hast.
|
|
289
|
+
> Was ich davon gelesen habe, steht noch im Gesprächsverlauf auf diesem Rechner. Passt das?"
|
|
290
|
+
|
|
291
|
+
Kommt der Vorschlag ohne Plan (Nein in Schritt 10, oder „noch einmal mit Testkunden"), lass den
|
|
292
|
+
Satz über den Plan weg:
|
|
293
|
+
|
|
294
|
+
> „Die Aufnahme ist 12,9 MB groß und liegt in `material/aufnahmen/2026-10-19-0912`. Ich würde sie
|
|
295
|
+
> löschen — in der Aufnahme steckt alles, was du getippt hast. Was ich davon gelesen habe, steht noch
|
|
296
|
+
> im Gesprächsverlauf auf diesem Rechner. Passt das?"
|
|
297
|
+
|
|
298
|
+
- **Ja:** Lösch **genau diesen einen** Ordner — nicht `material/aufnahmen/` als Ganzes, nicht die
|
|
299
|
+
`.gitignore` und `.ignore` daneben — und sieh nach, dass er weg ist.
|
|
300
|
+
- **Nein:** Er bleibt liegen. Sag, wo, und dass er nicht in Git landet.
|
|
301
|
+
|
|
302
|
+
Zum Schluss in zwei Sätzen ohne Fachjargon, was jetzt im Projekt steht, und **ein** konkreter
|
|
303
|
+
nächster Schritt.
|
package/skill/en/SKILL.md
CHANGED
|
@@ -13,7 +13,7 @@ description: Add projects to the kimal3 success profile or list them, analyse co
|
|
|
13
13
|
As soon as the person says a project is finished, or explicitly asks for it to be added.
|
|
14
14
|
**Or** when they want to set up their AI Workplace — then see “Setting up the workplace”.
|
|
15
15
|
|
|
16
|
-
## The
|
|
16
|
+
## The nine slash commands the person has
|
|
17
17
|
|
|
18
18
|
`kimal3 skill install` puts them in the global folder (`~/.claude/commands/`) — so the person can
|
|
19
19
|
type them in **any** folder. They are the route the person triggers themselves; this skill is the
|
|
@@ -24,11 +24,12 @@ route you recognise.
|
|
|
24
24
|
| `/k3` | Where they stand — and all kimal3 commands at a glance |
|
|
25
25
|
| `/k3start` | Start a session: where the project stands and what comes next |
|
|
26
26
|
| `/k3wrapup` (German: `/k3feierabend`) | End a session cleanly: save the status, tidy up, summarise |
|
|
27
|
-
| `/k3course` (German: `/k3kurs`) | Back into the Mini course —
|
|
27
|
+
| `/k3course` (German: `/k3kurs`) | Back into the Mini course — fetches the status with `kimal3 course` and picks up where they left off |
|
|
28
28
|
| `/k3project` (German: `/k3projekt`) | Add a finished project to the success profile |
|
|
29
29
|
| `/k3list` (German: `/k3liste`) | Show the projects they have added |
|
|
30
30
|
| `/k3analyse` | Fetch company data and answer their question about it |
|
|
31
31
|
| `/k3context` (German: `/k3kontext`) | Answer the open questions about their company in conversation |
|
|
32
|
+
| `/k3show` (German: `/k3zeigen`) | Show a task instead of describing it — records with `kimal3 show …`, evaluates on the computer and writes the plan; nothing is read before their yes |
|
|
32
33
|
|
|
33
34
|
`/k3`, `/k3start` and `/k3analyse` have the same name in German. Colleagues whose account is set to German have the German names — if someone says they ran `/k3feierabend`, that is `/k3wrapup`.
|
|
34
35
|
|
|
@@ -39,7 +40,7 @@ of pointing to a command.
|
|
|
39
40
|
|
|
40
41
|
⚠️ **`/k3start`, `/k3wrapup` and `/k3course` came ONLY with the course folder up to 0.2.4** — Pro
|
|
41
42
|
customers without the Mini course never had them, and they could not be updated at all. Since 0.2.5
|
|
42
|
-
the program delivers all
|
|
43
|
+
the program delivers all of them. *If you meet someone on an older version, a missing command there
|
|
43
44
|
is not an error but the old state.*
|
|
44
45
|
|
|
45
46
|
## 🔴 Several companies: YOU DO NOT CHOOSE
|
|
@@ -157,8 +158,7 @@ same — **because it is the right one**, not because the trap is still open.
|
|
|
157
158
|
together — there are four different ones. Search for square brackets instead of following a list:
|
|
158
159
|
a typed-out list goes out of date the moment the template grows. Ask, instead of guessing.
|
|
159
160
|
|
|
160
|
-
⚠️ You will usually find `[FIRMA]` already filled in — the server puts the name in when it delivers the folder.
|
|
161
|
-
`[DATUM]` likewise. What is left are the details about the **person** in front of you.
|
|
161
|
+
⚠️ You will usually find `[FIRMA]` already filled in — the server puts the name in when it delivers the folder. What is left are the details about the **person** in front of you.
|
|
162
162
|
|
|
163
163
|
🔴 **Only in the workbench — nowhere else.** The top-level `CLAUDE.md` and everything in `context/` (`kontext/` in a German company)
|
|
164
164
|
belong to the **company**, not to the person in front of you. The server puts in the company name
|
|
@@ -357,6 +357,11 @@ a legal right of co-determination over it. That is for the company to decide, no
|
|
|
357
357
|
- “If you were running the company, what would you automate next, measured against what has
|
|
358
358
|
worked so far — and which of it can be carried over to other departments?”
|
|
359
359
|
|
|
360
|
+
## Reading the course status (`kimal3 course`)
|
|
361
|
+
Shows where the person stands in the Mini course: one line per part, `Next:` with the next step and, behind it, who ticks
|
|
362
|
+
it off — "(you tick it off)" or "(Claude sets it)". Exit code `2` means not signed in, `3` not reachable — then **do not
|
|
363
|
+
retell the course from memory**. The slash command `/k3course` leads through it.
|
|
364
|
+
|
|
360
365
|
## Exit codes
|
|
361
366
|
`0` done · `1` **Retrying won't help — READ THE MESSAGE** · `2` sign-in missing ·
|
|
362
367
|
`3` temporary problem, retry once · `4` signed in, but no Pro access —
|
package/skill/en/commands/k3.md
CHANGED
|
@@ -84,17 +84,18 @@ Show the list in two groups:
|
|
|
84
84
|
| `/k3project <what you built>` (German: `/k3projekt`) | Add a finished project to the success profile |
|
|
85
85
|
| `/k3list` (German: `/k3liste`) | Show the projects you have added |
|
|
86
86
|
| `/k3analyse <your question>` | Fetch company data and answer your question about it |
|
|
87
|
+
| `/k3show` (German: `/k3zeigen`) | Show a task instead of describing it — I record it and turn it into a plan |
|
|
87
88
|
|
|
88
89
|
Also tell them: the slash commands are the **safe** route — you don't have to remember any sentence.
|
|
89
90
|
It works without them too: “the project is finished” is enough, and then I use the skill.
|
|
90
91
|
|
|
91
|
-
## 6. The
|
|
92
|
+
## 6. The tenth entry in the menu: `/kimal3` is NOT a command
|
|
92
93
|
|
|
93
94
|
The same `/` list also shows **`/kimal3`**. Explain the difference **without being asked** — the
|
|
94
95
|
menu throws two different kinds into one list, and that is exactly what tripped up the first
|
|
95
96
|
person who saw the family (Dennis, 19 August 2026):
|
|
96
97
|
|
|
97
|
-
- The
|
|
98
|
+
- The nine **`/k3…`** are **slash commands** (files in `~/.claude/commands/`) — **the person**
|
|
98
99
|
types them on purpose.
|
|
99
100
|
- **`/kimal3`** is the **skill** (`~/.claude/skills/kimal3/SKILL.md`) — my
|
|
100
101
|
operating manual. It is the reason “the project is finished” is enough: I open it
|
|
@@ -102,5 +103,5 @@ person who saw the family (Dennis, 19 August 2026):
|
|
|
102
103
|
names several things at once and doesn't read like a menu item.
|
|
103
104
|
|
|
104
105
|
Also say what `/kimal3` is **not**: **not the installation.** That is `kimal3 skill install`
|
|
105
|
-
in the terminal — the one command that puts both in place, the skill **and** the
|
|
106
|
+
in the terminal — the one command that puts both in place, the skill **and** the nine `/k3…`.
|
|
106
107
|
What appears in the menu is its result.
|