Skip to content

Releases

STG-DE v0.5.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 18:31
5773e66

Agent Skill

  • Der Skill verlangt nach jedem WRITE und REWRITE einen erneuten Lauf des Linters mit dem Endergebnis. Der Agent behebt jeden Befund mit der Stufe error, bevor er das Ergebnis zurückgibt. Ein vages Wort wie ggf. oder zeitnah ersetzt der Agent durch die genaue Bedingung oder Frist aus dem Ausgangstext, sonst schreibt er eine Hinweis:-Zeile. In den Evaluationen waren solche Wörter die häufigste Ursache für Fehler.

Linter

  • STG-8.1 meldet kein Semikolon zwischen Listeneinträgen mehr, zum Beispiel zwischen Autoren (Apfeld, R.; Schaefer, M.), Normen (IEC 60601-1; IEC 60601-1-2) oder Werten (-7,5; +15). Auf dem Holdout waren 10 von 12 Befunden dieser Art falsch. Semikolons zwischen Aussagen bleiben ein Fehler.

Evaluation

  • Wiederholung der Evaluation mit dem korrigierten Skill in evals/results/2026-11-12-rerun.md: Claude besteht 115 von 115 Prüfungen, Codex 112 von 115.
  • tools/run_evals.py liest für avoids … die Hinweis:-Zeile nicht mehr mit und erkennt die Ergebnis:-Zeile auch mit Markdown wie **FAIL**.

Struktur des Repositorys

  • Der Code von Linter, Analysewerkzeug und Vergleich steht nur noch in stg_de/. Die Kopien in tools/ sind entfernt. Der Skill enthält auch in Zukunft eine Kopie in scripts/, weil der Skill ohne das Repository funktionieren muss. Die GitHub Action und die Dokumentation verwenden stg_de/stg_lint.py.
  • STG-DE.md und manifest.yaml sind nicht mehr im Repository. Der Release-Workflow erzeugt beide Dateien und hängt sie an das GitHub-Release an.
  • Die Zahlen zu Regeln, Wörterbuch, Zuordnung und Korpus stehen nur noch in README.md. tests/test_readme_counts.py vergleicht diese Zahlen mit den Daten. dictionary/coverage.yaml ist entfernt.
  • Die Dokumente auf der obersten Ebene heißen einheitlich in Großbuchstaben: SPECIFICATION.md, SOURCES.md, VALIDATOR-CONTRACT.md.
  • dictionary/GOVERNANCE.md ist jetzt der Abschnitt „Lexikalische Änderungen“ in GOVERNANCE.md. Die Vorlage für lexikalische Vorschläge steht jetzt in proposals/LEX-CHANGE-TEMPLATE.yaml.

STG-DE v0.4.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 17:09
65046bc

Neue Nummerierung der Releases

  • Die Releases heißen jetzt 0.1.0 (vorher 0.4.0), 0.2.0 (vorher 0.5.0) und 0.3.0 (vorher 0.6.0). Die Entwürfe vor dem öffentlichen Repository heißen 0.0.1 bis 0.0.3.
  • Die Historie des Repositorys ist umgeschrieben. Die Dateien der alten Stände nennen die neuen Nummern. Die Tags v0.1.0, v0.2.0 und v0.3.0 zeigen auf diese Stände.

Aufräumen

  • ROADMAP.md nennt nur noch offene Arbeit. Erledigte Arbeit steht in diesem Änderungsprotokoll.
  • Die Vale-Regeln in vale/ sind entfernt. Der Linter prüft dieselben Fälle.
  • Die Dateien des alten Korpus aus 0.1.0 sind entfernt, auch tools/corpus_validate.py.
  • Neue Namen ohne Version: corpus/fulltext-sources.yaml, corpus/fulltext-metrics.yaml, tools/build_corpus.py.
  • Die Werte von review_status im Wörterbuch haben keine Version mehr, zum Beispiel provisional.
  • Ein Test prüft die Daten von Wörterbuch und Regelindex gegen die JSON-Schemas in schemas/.
  • build_standalone.py --check prüft in der CI, dass STG-DE.md zu den Quelldateien passt.

Modalität von Empfehlungen (STG-2026-002)

  • STG-GR-5 bleibt eine Empfehlung. Der Text verwendet jetzt den Imperativ statt „dürfen nicht“.
  • STG-DE-4.5: Ein Validator muss ein Pronominaladverb mit ungeklärtem Bezug zur Prüfung melden. Vorher war diese Meldung eine Empfehlung.
  • Spezifikation Abschnitt 10: Veröffentlichte Regel-IDs müssen auch vor 1.0 stabil bleiben. Ein Satz mit „Wir empfehlen“ ist auch in einer Pflichtregel eine Empfehlung.
  • dictionary/README.md nennt jetzt dieselbe Reihenfolge der Auflösung wie dictionary/MORPHOLOGY.md: zuerst die Morphologie, danach die Sperrliste.
  • dictionary/DECISIONS.md nennt den Autorenkern bis Version 0.1.

Korpus: Branchen und Textsorten (Issue #18)

  • 15 neue öffentliche Quellen in corpus/v0.2-sources.yaml. Die neuen Domänen sind Embedded und IoT, funktionale Sicherheit, Produktsicherheit, Messtechnik, IIoT und Energietechnik, Finanzen, B2B-Software und Texte für Agenten. Eine neue Quelle ist ein zweites Medizinprodukt. Neue Textsorten sind Release Notes, Anleitungen für Firmware-Updates, Anforderungsspezifikationen, FAQ für Hersteller und Anweisungen für Agenten.
  • Das Korpus hat jetzt 359.075 Token aus 28 Quellen.
  • Jede Quelle hat jetzt die Felder text_type, organization, accessed_on und extraction_method.
  • Eine Obergrenze von 10.000 Token je Quelle gleicht die Kennzahlen aus (capped_tokens, capped_coverage). Die größte Quelle hat jetzt 9,4 % der begrenzten Token. Vorher hatte das Medizinhandbuch 59 % aller Token.
  • Neue Holdout-Partition mit 7 Quellen. Die 4 Quellen der Messung für Linter 0.3.0 sind jetzt in der Entwicklungspartition (previous_partition: holdout, Protokoll Abschnitt 9).
  • build_corpus_v02.py liest Textdateien auch in der Kodierung cp1252, meldet Kennzahlen je Textsorte und liest die Version aus pyproject.toml.

Evaluation und Beispiele

  • 7 neue Fälle in evals/cases.yaml. Die Fälle sind eine Anforderung nach dem Muster EARS, eine Sicherheitsanforderung mit SIL, Release Notes, eine Meldung einer Schwachstelle und eine Prüfanweisung. Dazu kommen eine Anleitung für ein Firmware-Update und ein Audit.
  • Vier Beispiel-Glossare in examples/glossaries/: Embedded und IoT, funktionale Sicherheit, Produktsicherheit, Medizinprodukte.

Werkzeug für die Präzisionsmessung (Issue #19)

  • Fehler korrigiert: Die Stichprobe der Sätze ohne Befund konnte Sätze mit einem gemeldeten Wort enthalten. Der Linter meldet ein Wort aus der Sperrliste nur einmal je Dokument. Das Werkzeug prüft jetzt jeden Satz der Stichprobe einzeln.
  • Die Bewertungsdatei enthält jetzt die Quellen mit Hash und die Version des Linters. score verwendet diese Quellen.
  • Neue Bewertung skip: Ein Eintrag zählt dann nicht in den Kennzahlen.
  • Neue Optionen --sources und --prefill für sample.

Präzision auf dem Holdout (Issue #3)

  • Neues Werkzeug tools/holdout_precision.py: Stichprobe von Befunden auf dem Holdout, Bewertung und Kennzahlen. Fremder Text bleibt außerhalb des Repositorys.
  • Erste Messung für Linter 0.3.0 in corpus/HOLDOUT-PRECISION.md und corpus/holdout-precision.yaml: 92,9 % Präzision ohne Extraktionsfehler, 57 % der Befunde sind Extraktionsfehler. Ein Modell hat bewertet, ein Mensch hat die Bewertung noch nicht geprüft.

Linter

  • Befunde zu STG-1.1 nennen jetzt den ersten Satz mit dem Wort und die Zahl der Sätze mit dem Wort (occurrences).
  • •, ‣, ◦, ▪, ▸, → und – am Zeilenanfang gelten als Listenpunkte.
  • Abkürzungen wie bzw., z. B., ca., Nr. 5, Abb. 3 und Datumsangaben wie 31. Dezember beenden keinen Satz mehr. Linter und Analysewerkzeug verwenden dieselbe Satztrennung aus stg_markdown.py.
  • Der Linter wertet das Feld surface_forms der Sperrliste aus. 20 gesperrte Adjektive haben gebeugte Formen erhalten, zum Beispiel aktuellen und einfache.

Ergebnisse der Evaluation

  • Erste veröffentlichte Ergebnisse in evals/results/2026-11-12.md: Claude Code und Codex, jeweils mit Skill und ohne Skill. Mit Skill bestehen 94,8 % und 97,4 % der Prüfungen, ohne Skill 81,7 % und 82,6 %.
  • run_evals.py startet die CLI jetzt in einem leeren temporären Verzeichnis (--workdir). Der Agent liest dann nicht die Regeln des Repositorys.
  • Skill: Konformer Text bleibt in WRITE und REWRITE ohne Kommentar. Ein allgemeiner Vorschlag für mehr Genauigkeit ergibt im AUDIT kein PASS WITH REVIEW.

Zweite Messung der Präzision

  • Messung des Linters nach 0.3.0 auf den 7 neuen Holdout-Quellen: 79,8 % Präzision ohne Extraktionsfehler, 197 Befunde.
  • Zwei Modelle von zwei Anbietern bewerten jeden Befund unabhängig. Die Modelle hatten bei 93 % der Einträge dasselbe Label.
  • Die Prüfung STG-8.1 meldet Semikolons in Listen von Namen und Normen. 10 von 12 dieser Befunde sind falsch. Die Korrektur steht in ROADMAP.md.

Ordnung und Konsistenz

  • validate_release.py prüft die Zahl der Quellen gegen die Daten des Korpus statt gegen eine feste Zahl.
  • AGENTS.md enthält jetzt die einzige Liste der Prüfungen vor einem Commit. CONTRIBUTING.md und README.md verweisen auf diese Liste.
  • VERSIONING.md legt fest: schema_version ist die Version des Dateiformats. profiles/profiles.yaml hat jetzt schema_version 0.2.
  • Veraltete Titel mit „v0.1“ und englische Überschriften sind korrigiert. validator-contract.md beschreibt jetzt die echten Statuswerte und Schweregrade des Linters.
  • quality/RULE-COVERAGE.md stimmt jetzt mit quality/rule-coverage.yaml überein (19 implementierte Regeln).
  • Der Vorschlag STG-2026-001 hat den Dateinamen STG-2026-001-form-of-address.md.
  • CI prüft jetzt auch CHANGELOG.md mit dem Linter.

Verpackung

  • pyproject.toml verwendet die Lizenzangabe nach PEP 639.

STG-DE v0.3.0

Choose a tag to compare

@LinusAurel LinusAurel released this 12 Nov 17:04

Diese Version macht STG-DE in OpenAI Codex nutzbar und automatisiert Release und Aufräumen auf GitHub. Regeln, Wörterbuch und Werkzeuge bleiben inhaltlich gleich.

OpenAI Codex

  • Das Repository ist ein Codex-Plugin: .codex-plugin/plugin.json und der Marketplace .agents/plugins/marketplace.json.
  • agents/openai.yaml folgt den Vorgaben von Codex: kurze Beschreibung mit 25 bis 64 Zeichen und ein Standard-Prompt mit $simplified-technical-german.
  • SKILL.md nennt die Pfade der Skripte relativ zum Ordner des Skills. Codex führt Befehle im Projektverzeichnis aus.
  • Das README beschreibt die Installation in Codex als Plugin, über $skill-installer und als Ordner in .agents/skills/.
  • Tests prüfen Manifest, Marketplace und agents/openai.yaml.

Automatisierung auf GitHub

  • Der Workflow Release ist auch manuell startbar (workflow_dispatch mit version). Er erstellt dann den Tag auf main selbst. Die Notizen kommen aus dem Abschnitt der Version in CHANGELOG.md.
  • Neuer Workflow Clean up branches: Er löscht den Branch eines gemergten Pull Requests automatisch. Ein manueller Start löscht alle Branches ohne eigene Commits außerhalb von main.

STG-DE v0.2.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 17:00

0.2.0 — 2026-11-12

Diese Version ist die erste Version, deren Werkzeuge und Agent Skill für den praktischen Einsatz vorgesehen sind. Die kontrollierten Bedeutungen im Wörterbuch bleiben gleich. Alle veröffentlichten Regel-IDs bleiben stabil.

Anrede (STG-2026-001)

  • STG-5.3 erlaubt jetzt die Anredeformen sie (Standard), du und infinitiv. Ein Dokumentsatz verwendet genau eine Form. Die Einstellung anrede steht in .stg-de.yaml. Neuer Titel: „Anweisungen in einer festgelegten Anredeform“.
  • stg_lint.py prüft STG-5.3: error bei einer anderen als der festgelegten Anrede, warning bei gemischter Anrede ohne Festlegung. Neue Option --anrede.
  • Der Skill behält bei REWRITE die Anrede des Originals bei, wenn das Projekt keine Anrede festlegt.
  • Neues Schema schemas/project.schema.json für .stg-de.yaml.

Dokumentation auf Deutsch

  • Die Prosa des Repositorys ist jetzt deutsch und folgt selbst STG-DE. Das README enthält einen kurzen Abschnitt auf Englisch.
  • Die Markierungen <!-- stg-lint: off --> und <!-- stg-lint: on --> schließen absichtlich nicht konforme Beispiele von der Prüfung aus.

Zuordnung zu ASD-STE100

  • Neue Datei mapping/ste100-issue9.yaml: Alle 53 Schreibregeln und 8 Empfehlungen von ASD-STE100 Issue 9 sind STG-DE zugeordnet (35 gleich, 15 angepasst, 3 ersetzt). Jede STG-DE-Regel ist rückverfolgbar. Tests und validate_release.py prüfen die Vollständigkeit.
  • Neue Datei NOTICE.md. Das Repository enthält keinen Regeltext, keine Beispiele und keine Wörterbucheinträge aus ASD-STE100.

Werkzeuge

  • stg_lint.py prüft mehrere Dateien und Verzeichnisse und gibt Zeilennummern aus. Neu sind --fail-on {error,warning,review,never}, --format github für Annotationen in Pull Requests und das automatische Laden von ./.stg-de.yaml (--no-project schaltet das Laden ab).
  • stg_lint.py und stg_analyze.py zerlegen Markdown korrekt in Blöcke (Codeblöcke, HTML-Kommentare, Überschriften, Listenpunkte, Tabellenzellen). Die gemeinsame Logik steht in stg_markdown.py. Vorher zählte eine ganze Markdown-Liste als ein Satz.
  • stg_lint.py schützt zitierten Text vor lexikalischen Prüfungen. Zitierter Text zählt als ein Wort (STG-8.6).
  • Korrekturen nach einem Test mit einem echten deutschen Monorepo: Befunde in Sätzen über mehrere Zeilen haben jetzt eine Zeilennummer. Technische Begriffe aus dem Projektglossar haben Vorrang vor der zentralen Sperrliste. Ein geändertes zitiertes Wort („Provision“ → „Provisionen“) ergibt jetzt FAIL in der Bedeutungsprüfung.
  • Korrektur: Der Linter hat man zweimal gemeldet (STG-DE-4.3 und STG-1.1). Jetzt meldet nur STG-DE-4.3 das Wort.
  • Neues Werkzeug stg_compare.py für die Bedeutungsprüfung von Umschreibungen. Fehlende Zahlen, Einheiten, Code, URLs, Zitate, Kennungen oder Signalwörter ergeben FAIL. Geänderte Verbote, Modalität, Verneinungen, Einschränkungen, Bedingungen und Grenzwerte ergeben REVIEW.

Agent Skill

  • Neue Modi strikt (STG-T) und pragmatisch (STG-R) mit Standardwerten je Anwendungsprofil.
  • Neue Regeln für Texte, die Agenten lesen: Tool-Beschreibungen, Fehlermeldungen, Systemprompts.
  • Der Skill führt nach jeder Umschreibung stg_compare.py aus. Konformer Text bleibt unverändert.
  • Neue Beschreibung mit Auslösern auf Deutsch und Englisch und mit ausdrücklichen Ausschlüssen.
  • Neue Datei prompts/agents-md.md mit einer kurzen und einer vollständigen Fassung für AGENTS.md, CLAUDE.md, .cursorrules und Systemprompts.

Verpackung und CI

  • Python-Paket stg-de mit dem Befehl stg und den Unterbefehlen lint, analyze und compare (aus dem früheren Branch v0.5/tooling). Das Paket enthält Kopien der kanonischen Werkzeuge und Daten. tools/sync_package.py --check prüft die Kopien.
  • pre-commit-Hook stg-de-lint und erste Vale-Regeln in vale/.
  • Plugin und Marketplace für Claude Code in .claude-plugin/.
  • tools/package_skill.py erzeugt ein reproduzierbares ZIP des Skills mit SHA-256-Prüfsumme.
  • Wiederverwendbare GitHub Action action.yml für STG-DE-Prüfungen in anderen Repositorys.
  • Release-Workflow für Tags v*. Die CI erzeugt das ZIP und prüft das eigene Repository mit der Action.

Evaluation

  • evals/: Fälle für WRITE, REWRITE und AUDIT über alle sieben Anwendungsprofile, Prompts für die Auslöser und Referenzausgaben.
  • tools/run_evals.py: deterministische Bewertung. Das Werkzeug erzeugt Ausgaben mit jedem CLI, das einen Prompt über stdin liest.

Seit 0.1.0 (vorher nicht veröffentlicht)

  • Matrix der automatisierten Regeln (quality/rule-coverage.yaml) und Golden-Audit-Fälle.
  • Korpusprotokoll v0.2 mit festen Partitionen für Entwicklung, Validierung und Holdout. Das Korpus hat 139.646 Token aus 13 öffentlichen Volltextquellen (nur abgeleitete Metriken).
  • Schema und Vorlage für Lexikonvorschläge, Vorlage für Änderungsvorschläge, Governance, Versionierungsrichtlinie, Release-Checkliste und CITATION.cff.
  • Anwendungsprofile (procedure, safety, description, requirement, support, consumer, agent) in Linter und Skill.
  • Konservatives Analysewerkzeug stg_analyze.py für die deutsche Sprache.

STG-DE v0.1.0

Choose a tag to compare

@LinusAurel LinusAurel released this 12 Nov 17:02

Erster öffentlicher Stand des Repositorys vom 22.08.2026. Dieses Release wurde am 12.11.2026 nachträglich angelegt. Damals gab es keinen Tag.

Die Entwürfe vor dem öffentlichen Repository heißen 0.0.1 bis 0.0.3. Für diese Entwürfe gibt es keine Commits und keine Releases. Die Änderungen stehen in CHANGELOG.md.

Für dieses Release gibt es keine Artefakte mit Prüfsummen. Den Release-Workflow gibt es seit 0.2.0.