CommunityCodierung & Entwicklunggithub.com

Schnittstelle entwerfen

Generiert mehrere radikal unterschiedliche Schnittstellendesigns für ein Modul mit parallelen Sub-Agenten. Verwende diesen Skill, wenn der Benutzer eine API entwerfen, Schnittstellenoptionen erkunden, Modulformen vergleichen oder etwas 'zweimal entwerfen' möchte.

Was ist Schnittstelle entwerfen?

Dieser Skill unterstützt Entwickler dabei, bessere API- und Modulschnittstellen zu entwerfen, basierend auf dem Prinzip 'Design It Twice' aus 'A Philosophy of Software Design'. Die Kernidee ist, dass der erste Entwurf selten der beste ist – daher werden mehrere radikal unterschiedliche Designs erstellt und systematisch verglichen. Der Skill führt durch einen Workflow: Zuerst werden die Anforderungen gesammelt (Problem, Aufrufer, Operationen, Einschränkungen), dann werden parallel über die Task-Funktion 3+ Sub-Agenten gestartet, die jeweils eine klar definierte, unterschiedliche Designausrichtung erhalten (z. B. minimale Methodenanzahl vs. maximale Flexibilität vs. Optimierung auf den häufigsten Fall). Jeder Sub-Agent präsentiert sein Design mit Schnittstellensignatur, Nutzungsbeispiel, versteckter Komplexität und Abwägungen. Nach der sequenziellen Präsentation werden die Designs anhand von Kriterien wie Schnittstelleneinfachheit, Tiefe (kleines Interface mit großer versteckter Komplexität) und Abwägungen verglichen. Abschließend wird eine Synthese erstellt, die die besten Aspekte kombiniert. Der Skill vermeidet typische Anti-Patterns wie ähnliche Designs oder das Überspringen des Vergleichs. Er eignet sich für Plattformen wie Claude Code, Cursor und Codex, die parallele Sub-Agenten unterstützen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AppuzMathew9/Skill/tree/main/skills/design-an-interface

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Schnittstelle entwerfen?

Basierend auf „Design It Twice“ aus „A Philosophy of Software Design“: Deine erste Idee ist selten die beste. Erzeuge mehrere radikal unterschiedliche Designs und vergleiche sie dann.

Workflow

1. Anforderungen sammeln

Vor dem Entwurf verstehen:

  • Welches Problem löst dieses Modul?
  • Wer sind die Aufrufer? (andere Module, externe Benutzer, Tests)
  • Was sind die wichtigsten Operationen?
  • Gibt es Einschränkungen? (Leistung, Kompatibilität, bestehende Muster)
  • Was soll im Inneren verborgen vs. nach außen sichtbar sein?

Frage: „Was muss dieses Modul tun? Wer wird es nutzen?“

2. Designs erzeugen (parallele Sub-Agenten)

Starte gleichzeitig 3+ Sub-Agenten mit dem Task-Tool. Jeder muss einen radikal anderen Ansatz liefern.

Prompt-Vorlage für jeden Sub-Agenten:

Entwirf eine Schnittstelle für: [Modulbeschreibung]

Anforderungen: [gesammelte Anforderungen]

Einschränkungen für diesen Entwurf: [weise jedem Agenten eine andere Einschränkung zu]
- Agent 1: „Minimiere die Methodenanzahl – maximal 1-3 Methoden“
- Agent 2: „Maximiere die Flexibilität – unterstütze viele Anwendungsfälle“
- Agent 3: „Optimiere für den häufigsten Fall“
- Agent 4: „Lass dich von [bestimmtem Paradigma/Bibliothek] inspirieren“

Ausgabeformat:
1. Schnittstellensignatur (Typen/Methoden)
2. Nutzungsbeispiel (wie der Aufrufer sie verwendet)
3. Was dieser Entwurf intern verbirgt
4. Abwägungen dieses Ansatzes

3. Designs präsentieren

Zeige jedes Design mit:

  1. Schnittstellensignatur – Typen, Methoden, Parameter
  2. Nutzungsbeispiele – wie Aufrufer es in der Praxis verwenden
  3. Was es verbirgt – intern gehaltene Komplexität

Präsentiere die Designs nacheinander, damit der Benutzer jeden Ansatz vor dem Vergleich aufnehmen kann.

4. Designs vergleichen

Nachdem alle Designs gezeigt wurden, vergleiche sie anhand:

  • Schnittstelleneinfachheit: weniger Methoden, einfachere Parameter
  • Allgemein vs. spezialisiert: Flexibilität im Vergleich zum Fokus
  • Implementierungseffizienz: Ermöglicht die Form effiziente interne Abläufe?
  • Tiefe: Kleines Interface, das erhebliche Komplexität verbirgt (gut) vs. großes Interface mit dünner Implementierung (schlecht)
  • Leichte korrekte Nutzung vs. leichte Fehlnutzung

Diskutiere Abwägungen in Prosa, nicht in Tabellen. Hebe hervor, wo sich die Designs am meisten unterscheiden.

5. Synthese

Oft kombiniert das beste Design Erkenntnisse aus mehreren Optionen. Frage:

  • „Welches Design passt am besten zu deinem primären Anwendungsfall?“
  • „Gibt es Elemente aus anderen Designs, die es wert sind, integriert zu werden?“

Bewertungskriterien

Aus „A Philosophy of Software Design“:

Schnittstelleneinfachheit: Weniger Methoden, einfachere Parameter = leichter zu lernen und korrekt zu nutzen.

Allgemein nutzbar: Kann zukünftige Anwendungsfälle ohne Änderungen bewältigen. Aber Vorsicht vor Überverallgemeinerung.

Implementierungseffizienz: Ermöglicht die Schnittstellenform eine effiziente Implementierung? Oder erzwingt sie umständliche interne Abläufe?

Tiefe: Kleines Interface, das erhebliche Komplexität verbirgt = tiefes Modul (gut). Großes Interface mit dünner Implementierung = flaches Modul (vermeiden).

Anti-Patterns

  • Lasse Sub-Agenten keine ähnlichen Designs erstellen – erzwinge radikale Unterschiede
  • Überspringe den Vergleich nicht – der Wert liegt im Kontrast
  • Implementiere nicht – dies betrifft ausschließlich die Schnittstellenform
  • Bewerte nicht auf Grundlage des Implementierungsaufwands

Verwandte Skills