Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki:
raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht
tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren
Grenzen in Code durchgesetzt sind statt im Prompt.
Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige
Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses
Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44
Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist.
Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den
Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er
dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs.
Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte.
Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet -
siehe NOTICE.
Maschinelle Heuristiken zur Priorisierung der semantischen Prüfung: veraltete Aussagen, hohe Änderungsdichte und schwache Verlinkung
Semantic Lint Automation
Typ: workflow
Definition
Semantic Lint Automation bezieht sich auf Maschinen-Heuristiken, die potenzielle semantische Probleme im Wiki identifizieren und eine priorisierte Liste zur menschlichen oder LLM-Überprüfung bereitstellen. Im Gegensatz zu strukturellem Linting (das auf definite Fehler wie kaputte Links prüft), nutzt semantisches Linting Muster und Metriken, um wahrscheinliche Probleme zu kennzeichnen, die Urteile erfordern.
Kernpunkte
Heuristisch-basiert: Nutzt automatisierte Erkennung von Mustern, die mit semantischen Problemen korrelieren
Priorisierung: Ordnet Befunde nach wahrscheinlichem Schweregrad oder Auswirkungen
Nicht-deterministisch: Ergebnisse können variieren und erfordern menschliches Urteil
Ergänzt strukturelles Linting: Funktioniert neben dem bestehenden deterministischen wikitool lint
Heuristiken
Veraltete Aussagen: Identifiziert Fakten, die nicht kürzlich bestätigt wurden (z. B. >90 Tage)
Hohe Änderungsdichte: Kennzeichnet Seiten mit vielen neuen Änderungen, die überprüft werden müssen
Schwache Verlinkung: Findet Seiten, die Entities/Concepts erwähnen, aber nicht darauf verlinken
Niedriges Vertrauen: Identifiziert Aussagen mit Vertrauens-Scores unter Schwellenwerten
Sonnet-Verbesserung: Könnte Zeilenzahl-Ausreißer (Seitenqualitätsschwellen) und Index-Abschnittsgröße-Prüfungen einbeziehen1
Beispiele
Kennzeichnung: "Seite X erwähnt 'MQTT' 5 Mal, hat aber keinen MQTT-Link"
Kennzeichnung: "Seite Y hat 15 Änderungen in der letzten Woche - potenzial für Inkonsistenzen"
Kennzeichnung: "Aussage über Version 2.0.0 auf Seite Z wurde zuletzt vor 120 Tagen bestätigt"
Wann zu verwenden
Während regelmäßiger Wartung
Vor größeren Operationen (publish, archive)
Um Bereiche zu identifizieren, die Aufmerksamkeit benötigen
Wann NICHT zu verwenden
Als Ersatz für menschliches Urteil
Für definitive Fehlererkennung (verwenden Sie stattdessen strukturelles Linting)
Verwandte Concepts
Lint Workflow (vorhandenes Konzept für strukturelles Linting)
Confidence Scoring (wird verwendet, um Aussagen mit niedrigem Vertrauen zu identifizieren)
torben
18ae28f918