Skill „Wiki aktualisieren“
Aktualisiert die handgeschriebenen Prosa-Abschnitte von Wiki-Seiten, sodass sie den aktuellen Stand des Codebase widerspiegeln. Generierte Metrik-/Datenblöcke werden vom Orchestrator verwaltet und dürfen niemals verändert werden.
Wann wird es aufgerufen
- Benutzer gibt
/update-wikiein – aktualisiert alle Prosa-Seiten - Benutzer gibt
/update-wiki Architekturein – aktualisiert nurwiki/Architektur.md - Benutzer sagt „Wiki-Prosa aktualisieren“, „Onboarding-Text erneuern“ oder „Architekturdokumente umschreiben“
- Nach einem größeren Refactoring, das die Systemdesign-Beschreibung ändert
Was dieses Skill tut (Schritt für Schritt)
-
Umfang bestimmen. Falls ein Seitenname als Argument übergeben wurde (z. B.
Architektur), wird er zuwiki/{Seitenname}.mdaufgelöst. Andernfalls werden alle unten aufgeführten Prosa-Seiten in die Warteschlange gestellt. -
Für jede Zielseite: a. Die Wiki-Seitendatei lesen. b. Jeden
<!-- claude:prose -->...<!-- claude:prose:end -->-Block identifizieren. c. Die relevanten Quellcodedateien aus dem untenstehenden Seitenregister lesen, um den Kontext aufzubauen. d. Den Inhalt zwischen den Markern so umschreiben, dass er den aktuellen Codebase korrekt wiedergibt – dabei die allgemeine Struktur (Überschriften, Absatzreihenfolge) beibehalten, es sei denn, sie ist faktisch falsch. e. Den aktualisierten Inhalt wieder in die Datei schreiben, wobei die Marker exakt erhalten bleiben. -
Generierte Blöcke niemals berühren. Inhalte innerhalb von
<!-- generated:start -->...<!-- generated:end -->müssen bytegenau unverändert bleiben. Diese Blöcke werden vom Wiki-Orchestrator-Skript verwaltet. -
Architektur-Entscheidungslogik ist vollständig Claude-eigen.
wiki/Architecture-Decision-Log.mdenthält wedergenerated-Blöcke nochclaude:prose-Marker. Claude verwaltet die gesamte Datei. Beim Aktualisieren werden neue ADL-Einträge für alle Architekturentscheidungen angehängt, die seit dem letzten dokumentierten Eintrag getroffen wurden. Vorhandene Einträge dürfen nicht geändert werden. -
Commit-Aufforderung. Nachdem alle Seiten aktualisiert wurden, den Benutzer daran erinnern:
„Wiki-Prosa aktualisiert. Führen Sie
/commitaus, um die Änderungen zu speichern, und pushen Sie dann an das Wiki-Remote-Repository.“
Prosa-Seiten und ihre Quellcodedateien
wiki/Architektur.md
Zweck des Prosa-Blocks: Systemdesign-Beschreibung – erklärt Modulverantwortlichkeiten, Datenfluss und wie die statische Seite und der Lambda-Chat-Agent zusammenpassen.
Relevante Quellcodedateien zum Lesen:
WebContent/js/main.jsWebContent/js/filter.jsWebContent/js/carousel.jsWebContent/js/utils.jslambda/lambda_function.pyindex.html(für Seitenstruktur-Kontext)projects.html(für Seitenstruktur-Kontext)
wiki/Lambda-Chat-Agent.md
Zweck des Prosa-Blocks: Begründung des Agentenentwurfs – erklärt die Lambda-Architektur, das Laden der Wissensbasis, den Prompt-Aufbau und die Antwortverarbeitung.
Relevante Quellcodedateien zum Lesen:
lambda/lambda_function.pylambda/context/(alle.md-Dateien, falls vorhanden)
wiki/Mitwirken.md
Zweck des Prosa-Blocks: Onboarding-Beschreibung – erklärt den Entwicklungsworkflow, die Testphilosophie und die Projektkonventionen für neue Mitwirkende.
Relevante Quellcodedateien zum Lesen:
CLAUDE.mdMakefilepackage.jsonpyproject.toml.github/workflows/ci-cd.yml
wiki/Architektur-Entscheidungslogik.md
Spezielle Behandlung: Keine claude:prose-Marker. Claude besitzt die gesamte Datei. Neue ADL-Einträge anhängen; vorhandene niemals ändern.
Relevante Quellcodedateien zum Lesen:
- Aktuelles Git-Log auf signifikante Architekturänderungen prüfen
CLAUDE.mdfür aktuelle Tooling-Entscheidungenlambda/lambda_function.pyfür Backend-Entscheidungen
Regeln zur Marker-Erhaltung
<!-- claude:prose -->
[Claude schreibt diesen Inhalt um]
<!-- claude:prose:end -->
<!-- generated:start -->
[NIEMALS BERÜHREN – vom Orchestrator verwaltete Daten]
<!-- generated:end -->
- Die öffnenden und schließenden Marker müssen auf eigenen Zeilen und unverändert bleiben.
- Keine zusätzlichen Leerzeilen unmittelbar innerhalb der Marker einfügen.
- Marker nicht verschachteln.
Warnung
Verändern Sie NIEMALS <!-- generated:start --> ... <!-- generated:end -->-Blöcke. Diese Blöcke enthalten automatisch generierte Metriken und Tabellen, die vom Wiki-Orchestrator erzeugt werden. Wenn Sie sie verändern, führt der nächste Orchestrator-Lauf entweder zu einem Merge-Konflikt oder überschreibt Ihre Änderungen stillschweigend.