Files

T

DanielandClaude Opus 5.5 27589749ff Eingangsordner input/ und Skill sn-einlesen (#5 )

- input/ ist lokal und nicht versioniert (.gitignore); scripts/einlesen.py
  legt ihn bei Bedarf an.
- scripts/einlesen.py ordnet jede Datei ein: abgelehnt (kein .md, nicht
  UTF-8, leer, Unterordner), neu, geändert, eingelesen. Für neue und
  geänderte Dateien: Prozessname, Ordnernamen-Vorschlag, ob schon eine
  Arbeitsschritt-.md, und ähnliche Prozesse aus prozesse/ und entwuerfe/.
  „vermerk“ schreibt nach Erfolg eine erste Zeile
  <!-- eingelesen: <Zeitstempel> | neu|aktualisiert | <Ziel> | inhalt: <sha> -->;
  die Prüfsumme erkennt spätere Änderungen. Zeilenenden bleiben erhalten.
- Skill sn-einlesen: Übersicht, Bestandsvergleich, Entscheidung des
  Nutzers, neue Prozesse durch sn-bpmn, Vermerk nur bei Erfolg.
- docs/leitfaden/07_prozesse_einlesen.md: Ablauf für neue Nutzer.
- AGENTS.md, README, Leitfaden 03, Skill sn-bpmn, Fallstricke, STATUS.
- Tests: python -m pytest -q -> 79 bestanden (18 neu in
  tests/test_einlesen.py).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-09-23 14:09:48 +02:00

3.5 KiB

Raw Blame History

name, description

name	description
sn-bpmn	Wandelt eine Prozessbeschreibung (Rohtext, Stichpunkte oder bereits strukturierte Arbeitsschritt-.md) in eine BPMN-2.0-Datei für den Import in PICTURE um. Aufrufen, wenn ein Verwaltungsprozess als Ablaufdiagramm für PICTURE modelliert werden soll.

BPMN-Prozess-Konverter

Begleitet den Weg von einer (oft unstrukturierten) Prozessbeschreibung zu einer importierbaren BPMN-2.0-Datei für PICTURE, mit md_to_bpmn.py in diesem Verzeichnis.

Lies Anleitung.md in diesem Verzeichnis für die vollständige Markdown-Syntax (Schritt-Typen, Verzweigungen, Rücksprung-Erkennung, Verantwortliche/Swimlanes), Elementkatalog.md für die vollständige Liste der PICTURE-BPMN-Elemente und Modellierregeln.md für die fachlichen BPMN-Modellierregeln, bevor du eine Arbeitsschritt-.md schreibst oder bearbeitest.

Ablauf

Quelle ermitteln. Frage nach der Rohtext-, Word- oder PDF-Quelle, falls keine angegeben oder angehängt wurde. Liegen Beschreibungen im Eingangsordner input/, übernimmt der Skill sn-einlesen die Steuerung und ruft diesen Skill je Datei auf. Gibt es den Prozess schon unter prozesse/<name>/, ist dessen <name>.md der Ausgangspunkt: dann auf einem Arbeitsbranch direkt dort ändern statt in entwuerfe/, und nach Schritt 3 mit Schritt 5 weitermachen.
Entwurf erzeugen. Lies die Quelle und leite daraus eine strukturierte Arbeitsschritt-.md nach der Syntax aus Anleitung.md ab. Triff nachvollziehbare fachliche Annahmen (Schrittgrenzen, Verzweigungen, Verantwortliche wo erkennbar) und schreibe das Ergebnis nach entwuerfe/<name>.md (Verzeichnis bei Bedarf anlegen; <name> in Kleinbuchstaben mit Bindestrichen, z. B. antrag-pruefen). Gleiche den Entwurf gegen Modellierregeln.md ab und behebe Verstöße direkt im Entwurf. Fasse kurz zusammen, welche Annahmen getroffen wurden, und weise auf Stellen hin, die fachlich geprüft werden sollten.
Auf Freigabe warten. Nicht eigenständig weiterbearbeiten. Der Nutzer passt entwuerfe/<name>.md selbst an (Reihenfolge, Verzweigungen, Verantwortliche, Formulierungen) und meldet sich, wenn sie passt.
BPMN erzeugen. Erst nach ausdrücklicher Freigabe (z. B. "ist angepasst", "passt so", "wandle um"):
```
python .agents/skills/sn-bpmn/md_to_bpmn.py entwuerfe/<name>.md entwuerfe/<name>.bpmn
```
Ergebnis kurz melden (Anzahl Schritte/Kanten/Lanes, Pfad der Datei) und anbieten, das Modell im Repository abzulegen (Schritt 5).

Vorschau im Browser, offline: python scripts/vorschau.py entwuerfe/<name>.bpmn (geht auch direkt mit der .md, schon vor der Freigabe in Schritt 3). Beim Anbieten der Vorschau dazusagen, dass PICTURE abweichen kann.
Ablegen (nur auf Wunsch). Ablauf und Regeln: prozesse/README.md (ADR 0003). Kurz: Branch feature/<issue-nr>-<name> von main, Ordner prozesse/<name>/ mit <name>.md und Steckbrief README.md aus docs/vorlagen/prozess_readme.md (Status Entwurf, Annahmen aus Schritt 2 unter „Annahmen und offene Punkte“), dann python scripts/pruefe_prozesse.py --erzeugen und python -m pytest -q. Vorher prüfen, dass keine Namen, Aktenzeichen oder Verfahrensdaten in der .md stehen. Commit und Pull-Request-Text vorbereiten; pushen macht der Mensch. Den Status abgenommen setzt nie der Agent von sich aus.

Wenn der Nutzer direkt eine bereits fertige Arbeitsschritt-.md angibt und ausdrücklich nur die Umwandlung möchte, Schritt 2-3 überspringen und direkt umwandeln.

3.5 KiB Raw Blame History

BPMN-Prozess-Konverter

Ablauf

3.5 KiB

Raw Blame History