KI-Korrektur

Jamdesk kann viele der defekten Links und fehlenden Seitenbeschreibungen beheben, die ein Build meldet. Die Schaltfläche Fix with AI liest diese Build-Warnungen und schlägt für jede eine Änderung vor. Die von Ihnen genehmigten Korrekturen werden in Ihr verbundenes GitHub-Repository committet. Der Commit startet einen neuen Build.

Die Screenshots zeigen die Benutzeroberfläche auf Englisch.

Der jamdesk fix-CLI-Befehl macht dasselbe in Ihrem Terminal. Er schreibt in Ihre lokale Arbeitskopie und überlässt den Commit Ihnen.

Was wird behoben?

Fix with AI behebt drei Arten von Build-Warnungen:

• Defekte interne Links: ein Link-Fragment, das auf eine Überschrift verweist, die auf der Zielseite nicht mehr existiert, etwa ein Tippfehler (#instalation → #installation) oder eine übersetzte Seite, deren Überschrift umbenannt wurde.
• Fehlende Seitenbeschreibungen: eine Seite ohne description im Frontmatter. Jamdesk erstellt aus dem Seiteninhalt eine kurze Zusammenfassung, die Sie prüfen können.
• Fehlende Seitentitel: eine Seite ohne Titel erhält aus dem Seiteninhalt einen Titelvorschlag, den Sie prüfen können.

Eine Änderung wird nur vorgeschlagen, wenn das Ziel eindeutig aufgelöst werden kann. Unklare Fälle werden separat aufgelistet, damit Sie sie von Hand beheben.

Fix with AI stellt pro Projekt bis zu 1.000 KI-Anfragen innerhalb von 24 Stunden. Ergebnisse für unveränderte Seiten werden wiederverwendet und zählen nicht zum Limit.

Ablauf wählen

Die Einstellung AI Fixes legt fest, was Jamdesk mit behebbaren Warnungen tut. Zum Ändern klicken Sie in der Seitenleiste auf Settings und suchen die Karte AI Fixes unter General.

So funktioniert Auto-fix

Auto-fix wendet dieselben Korrekturen wie der Dialog an, einschließlich KI-verfasster Beschreibungen. Ignorierte Punkte werden übersprungen. Es gilt ab dem nächsten Build, nachdem Sie die Einstellung gespeichert haben.

Nach einem Build committet Jamdesk die Korrekturen in den Build-Branch des Projekts. Die Commit-Nachricht lautet docs: auto-fix 3 issues (via Jamdesk), als Autor tritt Jamdesk auf. Der Build zeigt in der Build-Historie ein Abzeichen Auto-fixed. Für Docs ohne GitHub speichert Jamdesk die Korrekturen direkt in Ihren Docs.

Was Sie bei jedem Durchlauf erwarten können:

• Jamdesk führt für den eigenen Commit keine Auto-fix-Korrektur erneut aus. Wenn dieser Build noch behebbare Warnungen hat, zeigt er Needs review, und Sie wenden sie im Dialog an.
• Eine Korrektur wird nur einmal angewendet. Wenn Sie sie rückgängig machen, wendet Jamdesk sie nicht erneut an, Ihre Rücknahme bleibt also bestehen. Eine Korrektur, die wieder auftaucht, erscheint unter Needs review.
• Builds, deren Warnungen sich seit dem letzten Durchlauf nicht geändert haben, werden übersprungen.
• Auto-fix pausiert, wenn der Build-Branch geschützt ist oder die Jamdesk-GitHub-App den Schreibzugriff verliert. Die Karte zeigt Paused. Beheben Sie die Ursache und speichern Sie Auto-fix erneut.
• Die täglichen KI-Limits gelten wie beim Dialog. Erreicht ein Projekt das Limit, überspringt der Durchlauf einige Korrekturen und meldet dies.
• Eine neue Beschreibung ändert die Seite, daher übersetzt der nächste Übersetzungslauf diese Seite erneut.

Voraussetzungen

• Ein verbundenes GitHub-Repository für das Projekt.
• Schreibzugriff für die Jamdesk-GitHub-App, damit die Korrekturen committet werden können. Der Dialog zeigt einen Link Grant access zu GitHub, wenn der Zugriff fehlt.
• Ein abgeschlossener Build mit Warnungen zu defekten Links oder fehlenden Beschreibungen.

Banner finden

Öffnen Sie Ihr Projekt und scrollen Sie auf der Projektstartseite zu Build History. Oberhalb der Build-Liste erscheint ein Banner mit einer Anzahl und einer Schaltfläche Fix with AI, wenn Ihr letzter Build behebbare Probleme hat.

Das Banner erscheint nur beim neuesten abgeschlossenen Build. Korrekturen beziehen sich immer auf den aktuellen Stand Ihrer Docs.

Fixes prüfen und anwenden

Wenn manche Probleme nicht behoben werden können

Der Dialog listet Warnungen ohne eindeutige Korrektur unter einer eigenen Überschrift auf und lässt sie unverändert. Häufige Gründe:

• Ein defekter Link, dessen Zielseite oder Überschrift nirgends existiert.
• Ein Navigationseintrag ohne passende Quelldatei.
• Eine Seite, für die der Agent keine Beschreibung erzeugen konnte.

Diese müssen manuell bearbeitet werden. Öffnen Sie die Seite im Editor oder in Ihrem Code-Editor. Korrigieren Sie den Link oder ergänzen Sie die Beschreibung. Pushen Sie, um neu zu bauen.

Empfehlungen ignorieren

Manche Warnungen sind es nicht wert, behoben zu werden: ein absichtlich defekter Link oder eine Platzhalterseite, die keine Beschreibung braucht. Das Deaktivieren einer Korrektur überspringt sie nur einmal. Ignorieren entfernt sie aus der Anzahl, bis Sie sie wiederherstellen.

Jede Zeile im Dialog hat eine Ignorieren-Schaltfläche, behebbar oder nicht. Ein Klick verschiebt den Punkt in einen eingeklappten Abschnitt Ignored am Ende. Die Banner-Anzahl auf der Projektstartseite sinkt entsprechend, nachdem Sie den Dialog schließen. Die passenden Warnungen verschwinden aus der Build-Historie für den aktuellen Build und alle folgenden. Ignore all macht dasselbe für alles, was noch aufgelistet ist.

So verhalten sich Ignorierungen:

• Gemeinsam und dauerhaft: Ignorierungen gelten für das ganze Projekt. Jedes Mitglied sieht dieselbe Liste. Sie bleiben über Builds hinweg bestehen. Jamdesk ordnet jede Warnung anhand ihres Inhalts zu, nicht anhand der Zeilennummer. Änderungen an anderen Teilen der Seite bringen einen ignorierten Punkt nicht zurück.
• Wiederherstellen: Erweitern Sie den Abschnitt Ignored und klicken Sie bei einem Punkt auf Restore. Wenn alles eines Builds ignoriert wurde, ist das Banner ausgeblendet. Ein kleiner Link „N ignored recommendations“ unter der Build-Historie öffnet dann den Dialog wieder.
• Geänderte Warnungen kehren zurück: Ein ignorierter Punkt erscheint wieder als neue Empfehlung, wenn sich das zugrunde liegende Problem ändert, etwa wenn der defekte Link nun auf ein anderes Ziel zeigt.

Auto-fix rückgängig machen

Jeder Auto-fix-Durchlauf hat eine Schaltfläche Undo. Öffnen Sie den Build in der Build-Historie und suchen Sie den Abschnitt Auto-fix. Er listet auf, was Jamdesk geändert hat, und verlinkt auf den Commit. Klicken Sie auf Undo und bestätigen Sie mit Undo auto-fix.

Jamdesk committet die vorherige Version der Dateien in Ihren Branch mit der Nachricht docs: undo Jamdesk auto-fix (via Jamdesk). Wurde eine Datei nach dem Auto-fix geändert, überspringt Jamdesk sie und listet sie auf. Machen Sie diese Dateien von Hand rückgängig.

Rückgängig gemachte Korrekturen werden ignoriert. Ihre Warnungen sind ausgeblendet, und Jamdesk wendet sie nicht erneut an. Um sie zurückzuholen, öffnen Sie Fix with AI und stellen Sie sie unter Ignored wieder her.

Korrekturen an Ihren KI-Agenten übergeben

Sie können einen Coding-Agenten wie Claude Code die Änderungen in Ihrem Repository vornehmen lassen. Klicken Sie im Fix-with-AI-Dialog auf Copy for your AI agent. Jamdesk kopiert einen Klartext-Prompt, der jede vorgeschlagene Korrektur mit Datei und Zeile sowie die von Hand zu behebenden Probleme auflistet. Ignorierte Punkte fehlen. Fügen Sie den Prompt in Ihren Agenten ein.

Im Terminal liefert jamdesk fix --json dem Agenten dieselbe Liste als JSON. Siehe Mit einem KI-Agenten verwenden.

Mit KI beheben vs. CLI

Dashboard und CLI korrigieren defekte Link-Anker. Sie unterscheiden sich darin, wo sie laufen und wie die Änderung übernommen wird.

Nutzen Sie den Dashboard-Ablauf für eine schnelle Reparatur ohne Jamdesk zu verlassen. Nutzen Sie die CLI, wenn Sie die Änderungen zuerst in Ihrer Arbeitskopie haben möchten, etwa um sie mit anderen Bearbeitungen zu bündeln.

Wenn Sie AI Fixes auf Off setzen, stoppen Sie die Dashboard-Prüfungen. jamdesk fix läuft weiterhin auf Ihrem Rechner. Um die Einstellung im Terminal zu ändern, führen Sie jamdesk ai-fix mit off, review oder auto aus:

jamdesk ai-fix auto

Wie geht es weiter?