italixcs/repo-cleaner

Repo Cleaner

Machen Sie den Zweck, den Nachweis und die erste nützliche Aktion eines guten Projekts leicht auffindbar. Verbessern Sie die Repository-Oberfläche, während das Anwendungsverhalten erhalten bleibt.

1. Erstellen Sie das Briefing

• Identifizieren Sie Repository, Zielgruppe, gewünschtes Ergebnis, Sprache sowie Audit vs. Implementierung. Wiederverwenden Sie bereits erteilte Autorisierungen.
• Lesen Sie die relevanten Anweisungen, die README, verlinkte Leitfäden, Lizenz, Paket-/Skill-Manifeste, Beispiele, Assets und die aktuellen GitHub-Metadaten. Überprüfen Sie den Quellcode nur, um Behauptungen und Befehle zu verifizieren.
• Überprüfen Sie den Arbeitsbaum und bewahren Sie nicht zusammenhängende Änderungen, die bestehende Lizenz und Namensnennungen. Lassen Sie die Sichtbarkeit unverändert, es sei denn, eine Änderung der Sichtbarkeit wurde ausdrücklich genehmigt.
• Stellen Sie gezielte Fragen zu fehlenden Fakten oder folgenreichen Entscheidungen: Zielgruppe, widersprüchliches Branding, nicht verfügbarer Zugang, unsichere Installation oder ein bedeutendes Rebranding. Lösen Sie routinemäßige Layout-Entscheidungen aus dem Projekt heraus. Arbeiten Sie unabhängig weiter, während Sie warten; erfinden Sie keine Fakten, um Fragen zu vermeiden.
• Verwenden Sie assets/repo-brief.md, wenn ein Arbeitsbrief hilfreich ist; fügen Sie es nicht zu jedem Ziel-Repository hinzu.

2. Prüfen Sie den Leserpfad

Lesen Sie references/audit-and-validation.md. Verfolgen Sie Entdeckung → erster Bildschirm → Nachweis → Installation → erster Erfolg → tiefere Hilfe.

Listen Sie die wenigen Lücken mit der größten Auswirkung auf, jeweils mit Beleg und Priorität. Trennen Sie sachliche Probleme von Geschmacksentscheidungen. Fügen Sie überflüssige Elemente hinzu, die entfernt werden sollen. Unterscheiden Sie fehlende Informationen von Informationen, die Ihren Tools nicht zur Verfügung stehen. Geben Sie bei reiner Audit-Arbeit die Ergebnisse und konkrete Empfehlungen zurück, ohne Dateien oder Einstellungen zu bearbeiten.

3. Bauen Sie eine kohärente Präsentation auf

Lesen Sie references/readme-and-visuals.md. Verwenden Sie standardmäßig das native GitHub-Dokumentstyling, standardmäßige flache Badges, gewöhnliche Navigationslinks und projektspezifische Nachweise. Verwenden Sie nicht die persönliche Profil-Ästhetik eines Autors, es sei denn, dies wurde angefordert. Lesen Sie references/readme-patterns.md, wenn Sie eine Struktur auswählen oder von Referenz-Repositories lernen. Wählen Sie eine für das Projekt geeignete Richtung und implementieren Sie dann die kleinste vollständige Menge an Assets und Dokumenten, die das Projekt verständlich und nutzbar macht.

• Beginnen Sie mit einem konkreten Versprechen, einem nützlichen visuellen Nachweis und einer klaren ersten Aktion. Halten Sie wichtige Informationen als echten Text.
• Fügen Sie ein Banner nur hinzu, wenn es nützlich ist; bevorzugen Sie eine konkrete Aufgabe, tatsächliche Ausgabe oder eine nützliche Vorschau gegenüber dekorativem Branding; erstellen Sie Screenshots von tatsächlichen Ausgaben. Kennzeichnen Sie Konzepte, Fixtures, Rekonstruktionen und lokale Vorschauen genau.
• Fügen Sie eine zurückhaltende Badge-Zeile mit funktionierenden Zielen und belegten Behauptungen hinzu.
• Behalten Sie das kürzeste verifizierte Installations- und Verwendungsbeispiel in der README. Verlinken Sie auf längere Plattform-Leitfäden, Fehlerbehebung und Beispiele, ohne diese zu duplizieren.
• Organisieren Sie öffentliche Dokumente und Assets, ohne den Anwendungsquellcode zu verschieben oder das Laufzeit-/Build-Verhalten zu ändern. Aktualisieren Sie Links beim Verschieben von Dokumentation.
• Passen Sie die Dokumentationstiefe an das Projekt an. Entfernen Sie generische Marketing-Kopien, wiederholte Schlagzeilen, erzwungene Funktions-Tabellen, Füllabschnitte, Badge-Wände, dekorative Diagramme und leere Ordnerhierarchien. Bewahren Sie die spezifische Stimme des Projekts.

Überprüfen Sie bei Skill-Repositories, ob der installierbare Ordner SKILL.md und jede referenzierte Ressource enthält. Trennen Sie dieses Paket von öffentlichen Marketing-Dokumenten. Dokumentieren Sie genaue Entdeckungspfade pro Host, Aufrufbeispiele, Voraussetzungen und Toolanforderungen. Geben Sie an, ob jeder Pfad zur Laufzeit getestet, gegen die Host-Dokumentation überprüft oder nur manuell nutzbar ist. Gehen Sie nicht von einem Plugin, einer Marketplace-Listung oder universeller Agentenunterstützung für einen einfachen Skill-Ordner aus.

4. Verbessern Sie die Auffindbarkeit durch wahrheitsgemäße Metadaten

Lesen Sie references/github-discovery.md. Schlagen Sie präzisen About-Text, eine nützliche echte Homepage (sofern vorhanden), belegbasierte Topics und ein Social-Preview-Asset vor. Überprüfen Sie die aktuellen GitHub-Limits, bevor Sie sie anwenden.

Wenden Sie autorisierte Einstellungen mit geeigneten Tools an und bewahren Sie relevante vorhandene Werte. Wenn Tools eine Operation nicht unterstützen, bereiten Sie die genauen Werte und den Einstellungslink vor. Trennen Sie angewendet, vorbereitet und blockiert. Eine committete Metadaten-Datei oder ein Social-Image konfiguriert nicht GitHub. Ändern Sie niemals die Sichtbarkeit, kontaktieren Sie andere oder reichen Sie Werbelistungen ohne Autorisierung ein.

5. Verifizieren und Übergeben

Validieren Sie den Leserpfad anhand der Audit-Referenz: Links und Anker, Bilder, sicherer Schnellstart, wahrheitsgemäße Badges und Kompatibilität, Desktop/Mobil, Hell/Dunkel, finales Diff und Einstellungsrückmeldung. Melden Sie Tool- oder Netzwerklimits explizit. Speichern Sie Quell-Assets, sodass spätere Aktualisierungen praktikabel bleiben.

Committen oder pushen Sie nur bei Autorisierung und folgen Sie dem Workflow des Ziel-Repositories. Bestätigen Sie Ziel und endgültige Revision. Fassen Sie Änderungen, Verifizierung, nicht angewendete Einstellungen und die wenigen verbleibenden Aktionen zusammen. Versprechen Sie keinen Traffic, keine Sterne, kein Ranking oder keine ungetestete Unterstützung.