Zur Nutzungsanleitung springen
Building Componentsvon vercel

Building Components Skill.

Entwerfen Sie wiederverwendbare UI-Komponenten-APIs mit Blick auf Barrierefreiheit und Distribution.

  • Komponenten-APIs
  • Barrierefreiheit
Quellprüfung · building-componentsSKILL.md
Aufgabe Entwerfen Sie wiederverwendbare UI-Komponenten-APIs mit Blick auf Barrierefreiheit und Distribution. Ergebnisse Bei einer Implementierungsaufgabe eine Komponente mit explizitem Kompositions- und Zustandsmodell. Vor dem Start Die kurze SKILL.md benötigt ihre mitgelieferten Referenzen für detaillierte Implementierungsanleitungen.
Redaktionelle Zusammenfassung · Quelle geprüft am 2026-11-02 · kein generiertes Beispiel

01 Funktionen

Entwerfen Sie wiederverwendbare UI-Komponenten-APIs mit Blick auf Barrierefreiheit und Distribution

Planen Sie barrierefreie Komponenten-APIs, kontrollierten Zustand, Stile, Tokens und Distribution mit Vercels Building Components Skill.

Quellenbasierter WorkflowKein Ausführungs-Benchmark

Die Arbeitsweise

Building Components erklärt die technischen Entscheidungen hinter einer wiederverwendbaren UI-Bibliothek. Der Skill führt einen Agenten zu gezielten Referenzen für Komposition, Tastaturverhalten, Zustandsverwaltung, TypeScript-Schnittstellen und Gestaltung. Der Einstieg behandelt Primitive, Komponenten, Blöcke und Vorlagen, damit die Abstraktionsebene zur tatsächlichen Aufgabe passt.

Der Skill eignet sich für Komponenten, die von mehreren Aufrufern genutzt werden und nicht nur auf einem einzelnen Bildschirm. Er betrachtet API-Form, Barrierefreiheit und Distribution gemeinsam. Die Quelle ist vor allem ein Referenzindex: Die verlinkten Dateien gehören zum einsatzfähigen Skill und sollten mit der Einstiegsdatei vorliegen.

Erwartete Ergebnisse

  • Bei einer Implementierungsaufgabe eine Komponente mit explizitem Kompositions- und Zustandsmodell.
  • Bei einer Dokumentationsaufgabe eine Anleitung zur Komponenten-API und zum relevanten Verhalten.
  • Einen passenden Paketierungs- oder Registry-Plan, wenn Distribution zur Aufgabe gehört.
Beispiel-Briefing ansehen

Vom Briefing zur Prüfung

  1. 01
    Den Komponentenvertrag bestimmen

    Klären Sie, ob es um ein Primitiv, eine Komponente, einen Block oder eine Vorlage geht. Definieren Sie die öffentliche Schnittstelle und die Kontexte, in denen Aufrufer sie zusammensetzen.

  2. 02
    Relevante technische Anleitungen lesen

    Lesen Sie state.mdx zu kontrolliertem und unkontrolliertem Verhalten, composition.mdx zum öffentlichen Kompositionsmodell und accessibility.mdx zu Tastatur- und Fokusanforderungen. Ziehen Sie types.mdx und styling.mdx für die Implementierung heran. Ergänzen Sie Referenzen zu Polymorphie oder as-child nur, wenn Aufrufer diese API-Muster brauchen.

  3. 03
    Die Schnittstelle implementieren und dokumentieren

    Verbinden Sie Zustand und Darstellung über die gewählte API. Erläutern Sie die vorgesehene Nutzung und wählen Sie npm, eine Registry oder einen anderen dokumentierten Verteilungsweg nur bei Bedarf.

02 Einsatzbereiche

Wann einsetzen?

Die kurze SKILL.md benötigt ihre mitgelieferten Referenzen für detaillierte Implementierungsanleitungen.

Gut geeignet

  • Gemeinsame Komponenten-APIsEine gemeinsam genutzte Komponente braucht eine durchdachte öffentliche API, bevor mehrere Teams sie übernehmen.
  • BibliotheksentwicklungEine UI-Bibliothek benötigt einheitliche Praktiken für Barrierefreiheit, Themes und Dokumentation.

Zu prüfende Grenzen

  • Mitgelieferte ReferenzenDie kurze SKILL.md benötigt ihre mitgelieferten Referenzen für detaillierte Implementierungsanleitungen.
  • PrüfumfangDie Einstiegsdatei zertifiziert weder die Barrierefreiheit einer Komponente noch garantiert sie Kompatibilität mit jedem Framework.

Diese Eingaben mitbringen

  • Vorgesehene NutzerDie vorgesehenen Nutzer der Komponente und Verwendungsbeispiele.
  • Repository-KonventionenKomponenten-Stack, Token-System und TypeScript-Konventionen des Repositorys.
  • Verhalten und DistributionErforderliches Tastaturverhalten, Zustandsverantwortung und Distributionsziel.

03 Wichtige Entscheidungen

Wichtige Entscheidungen

  1. Klare Zustandsverantwortung

    Kontrollierter und unkontrollierter Zustand werden bewusste API-Entscheidungen.

  2. Kompositionsmöglichkeiten

    Die Referenzen behandeln slots, render props und as-child zur Komposition einer öffentlichen Komponenten-API.

  3. Distribution planen

    Veröffentlichung und Dokumentation werden zusammen mit der Implementierung betrachtet.

04 Beispielbriefing

Ein konkretes Briefing ausprobieren

Das folgende Beispiel-Briefing wurde nicht getestet. Prüfen Sie die Einrichtung des Skills, bevor Sie es verwenden.

Quelle und Einrichtung prüfen

Die vorgesehenen Nutzer der Komponente und Verwendungsbeispiele.

Upstream-Quelldatei
https://github.com/vercel/components.build/blob/ba727450437385af662810329fa19896215f76d5/skills/building-components/SKILL.md

Der folgende Verweis öffnet die Originalanleitung. Prüfe vor der Nutzung die Einrichtung des Repositorys; dies ist kein Installationsbefehl.

Mit einem Ergebnis beginnen

Passen Sie Umfang, Quellmaterial und Rahmenbedingungen in diesem Briefing an, bevor Sie den Skill ausführen.

Beispiel-Briefing
Verwende building-components, um eine wiederverwendbare Aufklappkomponente für unsere React-Komponentenbibliothek zu entwerfen. Prüfe zunächst unsere vorhandenen Primitive, Tokens und TypeScript-Muster. Schlage vor der Implementierung die öffentliche API einschließlich kontrolliertem und unkontrolliertem Zustand vor. Lies die relevanten Referenzen zu Komposition, Barrierefreiheit und Zustand. Berücksichtige Tastaturinteraktion und Fokusverhalten, zeige Beispiele für die Kombination von Auslöser und Inhalt und dokumentiere die Gestaltung mit unseren bestehenden Tokens. Behandle eine Veröffentlichung über Registry oder npm als separaten Vorschlag, sofern die aktuelle Aufgabe nicht ausdrücklich ein Release umfasst.

Ergebnis prüfen

Prüfen Sie die tatsächliche Ausgabe anhand dieser beobachtbaren Kriterien.

  • Nutzungsbeispiele verwenden die dokumentierte öffentliche API statt privater Interna.
  • Für Tastatur-, Fokus- und Zustandsverhalten liegen explizite Prüfergebnisse vor.
  • Paketierungsanweisungen passen zum vorgesehenen Distributionskanal.

OpenDesign bietet einen lokalen Design-Arbeitsbereich für Coding-Agenten. Dieser Eintrag bedeutet nicht, dass der Skill mitgeliefert wird oder dass seine externen Tools, Zugangsdaten und Software-Abhängigkeiten enthalten sind.

05 Quelle und Lizenz

Quelle und Lizenz

Diese Seite beschreibt die unten verlinkte, festgelegte Quellrevision. Verhalten und Anforderungen im Upstream können sich ändern.

Quellinhaber
vercel
Skill-Datei
SKILL.md
Geprüfter Stand
2026-11-02 · ba7274504373

Lesehinweise

  1. LizenzumfangWidersprüchliche Angaben im selben fixierten Upstream-Stand: Die LICENSE im Stammverzeichnis nennt ausdrücklich Apache License 2.0, während der Abschnitt License in README.md MIT nennt und auf diese Datei verlinkt. Unter skills/building-components gibt es keine lokale abweichende Regelung. Zeigen Sie kein uneingeschränktes MIT-Label an; der Anbieter muss den Widerspruch klären.
Redaktionelle Quellenzusammenfassung
Entwerfen Sie wiederverwendbare UI-Komponenten-APIs mit Blick auf Barrierefreiheit und Distribution.

Originalzusammenfassung von OpenDesign auf Grundlage der verlinkten Quelle. Repository-Sterne sind ein datiertes Popularitätssignal, keine Skill-Nutzung und keine Qualitätsbewertung.

06 Fragen vor dem Start

Fragen vor dem Start

Liefert der Skill ein fertiges visuelles Theme?

Der Einstieg konzentriert sich auf Komponentenentwicklung und verweist auf Token- und Styling-Referenzen. Die visuellen Anforderungen muss das Produkt weiterhin vorgeben.

Braucht jede Komponente Polymorphie?

Nein. Polymorphie und as-child sind verfügbare Referenzthemen, die gewählt werden, wenn die API sie benötigt.

Hilft der Skill bei der Distribution über eine Registry?

Ja. Für Registry-Distribution, npm-Veröffentlichung und Komponenten-Marktplätze gibt es jeweils eine eigene verlinkte Referenz.

OpenDesign

Briefing und Designarbeit an einem Ort.

Halten Sie Briefing, Quellmaterial und Designarbeit in einem lokalen Arbeitsbereich zusammen. Prüfen Sie die Einrichtung des Skills, bevor Sie ihn in Ihren Workflow aufnehmen.

Upstream-Quelldatei
https://github.com/vercel/components.build/blob/ba727450437385af662810329fa19896215f76d5/skills/building-components/SKILL.md