Communitygithub.com

Omar-Obando/qwen-orchestrator

Fähigkeit zur Erkennung und Vermeidung von Anti-Patterns. Erfasst hartcodierte Daten, nicht funktionale UI-Elemente, Platzhaltercode, N+1-Abfragen und andere häufige Entwicklungs-Anti-Patterns, bevor sie ausgeliefert werden.

Was ist qwen-orchestrator?

Diese Fähigkeit (Skill) dient der automatischen Erkennung und Prävention von Anti-Patterns in der Softwareentwicklung – von UI/UX-Schwächen über Code-Mängel bis hin zu SQL-Problemen. Sie stellt sicher, dass jeder Teil einer Anwendung echt, funktional und professionell ist. Der Skill bannt Praktiken wie 'Coming Soon'-Abschnitte, nicht funktionale Buttons, hartcodierte Fake-Daten, N+1-Abfragen, Platzhalter-Funktionen und SQL-Injection-Gefahren. Er gibt klare, regelbasierte Anweisungen, was stattdessen erforderlich ist – z. B. echte API-Aufrufe, vollständige Implementierungen, buchbare Serviceseiten und eine konsistente Designsprache. Der Skill ist plattformunabhängig und kann in agentenbasierten Entwicklungstools wie Claude Code, Cursor oder Codex eingesetzt werden. Er ist als strikte Checkliste konzipiert, die vor der Abnahme eines Deliverables Punkt für Punkt abgearbeitet werden muss – von der Navigation über SEO bis hin zur Datenbankabfrage. Der Skill ist besonders nützlich, wenn ein Agent für einen Kunden eine vollständige Website oder ein Produkt baut und sicherstellen muss, dass keine halbfertigen oder unprofessionellen Elemente ausgeliefert werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/anti-pattern

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Anti-Pattern Skill — Echten Code ausliefern, keine Dekorationen

Dieser Skill erkennt und verhindert die häufigsten Anti-Patterns, die Software unfertig oder unprofessionell wirken lassen.

Verbotene Anti-Patterns (NULL TOLERANZ)

UI/UX Anti-Patterns

❌ VERBOTEN:
- „Coming Soon“-Abschnitte oder -Beschriftungen
- Nicht funktionale Schaltflächen (müssen funktionieren oder entfernt werden)
- Formulare, die nirgendwo hinsenden
- Hartcodierte Fake-Daten in Produktionskomponenten
- Statische Tabellen, die sich als dynamisch ausgeben
- Links, die nirgendwo hinführen (href="#")
- „Baustelle“-Banner
- Feature-Flags, die dauerhaft auf false gesetzt sind
- Deaktivierte Eingabefelder ohne klare Erklärung
- Leere Zustände ohne hilfreiche Nachricht
- Paginierung, die nicht wirklich paginiert
- Suchleisten, die nicht wirklich suchen
- Filter, die dieselben Ergebnisse zurückgeben
- EINZELNE LANDING-PAGE, wenn der Nutzer „eine Website“ verlangt (MUSS mehrseitig sein)
- Keine Farbpalette vor dem Schreiben von CSS definiert
- Zufällige Hex-Farben ohne dokumentiertes Designsystem
- Inkonsistente Farben über Seiten hinweg (unterschiedliche Blautöne, unterschiedliche Abstände)
- EMOJIS irgendwo auf der Website (SVG-Icons von Lucide/Heroicons/Phosphor verwenden)
- Abschnitte, die sich berühren (kein Abstand zwischen Inhaltsblöcken)
- Footer direkt am oberen Abschnitt klebend (kein atmender Raum)
- Navigation mit mehr als 7 Einträgen auf oberster Ebene (überladen, überwältigend)
- Dienstleistungsseiten ohne individuelle Detailseiten (/services nur, kein /services/webdesign)
- Produktseiten ohne individuelle Detailseiten (/products nur, kein /products/[slug])
- Generische Dienstleistungsbeschreibungen (2-3 Zeilen pro Dienstleistung sind NICHT genug)

✅ ERFORDERLICH:
- Jeder sichtbare Button löst einen echten Handler aus oder wird entfernt
- Jedes Formular hat ein echtes onSubmit, das mit einem API-Aufruf verbunden ist
- Jede Liste lädt aus einer echten Datenquelle mit Ladezuständen
- Jeder Link navigiert zu einem echten Ziel
- Leere Zustände erklären warum und schlagen nächste Schritte vor
- Fehlerzustände zeigen echte Fehlermeldungen vom Server
- Ladezustände werden während echter asynchroner Operationen angezeigt
- Mehrseitige Website mit separaten Routen (Startseite, Über uns, Dienstleistungen, Kontakt, Produkte)
- Professionelle 6-Farben-Palette (--color-primary, secondary, accent, bg, surface, text)
- Konsistentes Designsystem über ALLE Seiten hinweg
- NULL Emojis – SVG-Icons verwenden (Lucide, Heroicons, Phosphor)
- Abschnittsabstand: mindestens 80px Padding zwischen Abschnitten
- Footer: mindestens 128px oberer Padding (niemals den Inhalt darüber berührend)
- Navigation: max. 7 Einträge, Dropdowns für Gruppen, sekundäre Links im Footer
- Dienstleistungen: Listenseite + individuelle Detailseiten pro Dienstleistung
- Produkte: Listenseite + individuelle Detailseiten pro Produkt
- Jede Dienstleistungsdetailseite: Beschreibung, Ablauf, Leistungen, Preise, FAQ, CTA
- Jede Produktdetailseite: Galerie, Spezifikationen, Preise, Bewertungen, ähnliche Produkte

Anti-Patterns der Website-Architektur

❌ VERBOTEN (wenn der Nutzer sagt „baue eine Website“):
- Die index.html als EINZIGE Datei erstellen
- Den gesamten Inhalt in eine scrollbare Seite packen
- Anker-Links (#about, #services) anstelle separater Seiten verwenden
- Es als „Website“ bezeichnen, obwohl es nur eine Landing-Page ist
- Kein Navigationsmenü zwischen Abschnitten/Seiten
- Kein gemeinsamer Header/Footer über alle Seiten hinweg
- Keine einzigartigen Meta-Titel/-Beschreibungen pro Seite

✅ ERFORDERLICH:
- Separate Route/Seite für jeden Abschnitt (z. B. /about, /services, /contact)
- Navigationsmenü, das alle Seiten verlinkt
- Gemeinsame Header- und Footer-Komponenten
- Jede Seite hat einen einzigartigen <title> und <meta description>
- Konsistente Farbpalette und Typografie über ALLE Seiten hinweg
- Mindestens 5 Seiten für jede „Website“-Anfrage (Startseite, Über uns, Dienstleistungen, Produkte/Portfolio, Kontakt)

Code Anti-Patterns

❌ VERBOTEN:
- return []; // TODO: implementieren
- throw new Error('Nicht implementiert');
- // Platzhalter
- Hartcodierte Arrays, die sich als API-Antworten ausgeben
- Funktionen mit leerem Rumpf
- Catch-Blöcke, die Fehler stillschweigend verschlucken
- Auskommentierter Code in der Produktion
- Magische Zahlen ohne benannte Konstanten
- Kopierter Code (DRY-Verletzung)
- Monsterfunktionen (>100 Zeilen)
- Tief verschachtelte Callbacks (>3 Ebenen)
- N+1-Datenbankabfragen in Schleifen

✅ ERFORDERLICH:
- Jede Funktion hat eine echte, funktionierende Implementierung
- Jeder Fehler wird ordnungsgemäß mit Benutzerfeedback behandelt
- Konstanten sind benannt und dokumentiert
- Code ist DRY – gemeinsame Logik extrahieren
- Funktionen sind fokussiert und unter 40 Zeilen

N+1-Abfrageerkennung

❌ VERBOTEN (N+1):
// Dies feuert 1 Abfrage pro Benutzer = N+1-Problem
for (const user of users) {
  const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}

✅ ERFORDERLICH (Batch):
// Dies feuert insgesamt 1 Abfrage
const userIds = users.map(u => u.id);
const orders = await db.query(
  'SELECT * FROM orders WHERE user_id IN (?)',
  [userIds]
);
// Dann im Speicher gruppieren
const ordersByUser = groupBy(orders, 'user_id');

SQL Anti-Patterns

❌ VERBOTEN:
SELECT * FROM users                    -- Kein SELECT *
WHERE name LIKE '%" + input + "%'     -- SQL-Injection
ORDER BY RAND()                        -- Performance-Killer
HAVING COUNT(*) > 0                    -- WHERE verwenden
WHERE YEAR(created_at) = 2024          -- Zerbricht Index-Nutzung

✅ ERFORDERLICH:
SELECT id, name, email FROM users      -- Explizite Spalten
WHERE name LIKE ?                      -- Parametrisiert
ORDER BY id DESC LIMIT 20              -- Deterministische Sortierung
WHERE created_at >= '2024-01-01'       -- Index-freundlich
  AND created_at < '2025-01-01'

Verifikations-Checkliste

Bevor EIN Auslieferungsgegenstand als abgeschlossen markiert wird:

Allgemein

  • Kein „Coming Soon“ oder „Baustelle“ irgendwo
  • Alle Schaltflächen sind funktional oder entfernt
  • Alle Formulare senden an echte Endpunkte
  • Alle Listen laden aus echten Datenquellen
  • Keine hartcodierten Demodaten in Produktionspfaden
  • Keine N+1-Abfragen (jede Schleife mit einer Abfrage prüfen)
  • Keine TODO-Kommentare ohne Issue-Referenzen
  • Fehlerzustände behandeln echte Fehler
  • Ladezustände werden während echter Operationen angezeigt

Design & UI Anti-Patterns

  • Keine Emojis irgendwo auf der Website (nur SVG-Icons verwenden)
  • Abschnitte haben mindestens 80px Abstand zueinander (keine Berührung)
  • Footer hat mindestens 128px oberen Padding (nicht am Inhalt klebend)
  • Hauptnavigation hat max. 7 Einträge auf oberster Ebene
  • Sekundäre Links im Footer, nicht in der Hauptnavigation
  • Dienstleistungen haben individuelle Detailseiten (nicht nur eine Listenseite)
  • Produkte haben individuelle Detailseiten (nicht nur eine Listenseite)
  • Jede Dienstleistungsdetailseite hat: Beschreibung, Ablauf, Leistungen, CTA
  • Jede Produktdetailseite hat: Galerie, Spezifikationen, Preise, Bewertungen
  • Abwechselnde Abschnittshintergründe zur visuellen Trennung

SEO Anti-Patterns (für Website-Projekte)

  • Keine Seite ohne einen einzigartigen <title> und <meta name="description">
  • Keine Seite ohne Open-Graph-Tags (og:title, og:description, og:image)
  • Keine Seite ohne JSON-LD-Strukturdaten (<script type="application/ld+json">)
  • Keine Nicht-Startseite ohne BreadcrumbList-Schema
  • Keine doppelten JSON-LD-Blöcke (stattdessen @id-Referenzen verwenden)
  • Keine fehlende robots.txt oder sitemap.xml
  • Keine Bilder ohne alt-Text
  • Keine Seite ohne kanonische URL
  • Kein fehlendes <html lang="xx">-Attribut
  • Keine Seite mit mehr als einem <h1>

Wann NICHT zu verwenden

Verwende diesen Skill NICHT, wenn:

  • Allgemeine Codequalitätsprüfungen durchgeführt werden (verwende code-review-skill für breitere Analysen)
  • Datenbankschemata entworfen werden (verwende database-design-skill für Schemaplanung)
  • Geschäftslogik für Anwendungen geschrieben wird (verwende domain-driven-skill für vollständige Module)
  • API-Endpunkt-Implementierungen überprüft werden (verwende api-design-skill für Endpunkt-Muster)
  • Sicherheitsaudits durchgeführt werden (verwende security-auditor-skill für Schwachstellenanalysen)
  • Bereitstellungskonfigurationen analysiert werden (verwende deployment-skill für CI/CD-Pipelines)
  • Git-Workflows oder Versionsverwaltung überprüft werden (verwende git-workflow-skill für Branching/Commits)
  • SQL-Abfragen geschrieben werden (verwende sql-best-practices-skill für Abfrageoptimierung)
  • Layouts für mehrseitige Websites entworfen werden (verwende design-system-skill für professionelles UI/UX)
  • Vorhandener Code auf Refactoring-Bedarf überprüft wird (verwende refactoring-skill für sichere Transformationen)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills