L'approccio di lavoro
Building Components guida le decisioni tecniche alla base di una libreria UI riutilizzabile. Indirizza l’agente a riferimenti specifici su composizione, tastiera, gestione dello stato, interfacce TypeScript e stili. Il punto di ingresso copre primitive, componenti, blocchi e template, adattando il livello di astrazione al risultato richiesto.
La skill è utile quando un componente deve servire più utilizzatori anziché una sola schermata. Considera insieme forma dell’API, accessibilità e distribuzione. La fonte è soprattutto un indice: i file collegati sono parte della skill operativa e devono accompagnare il file di ingresso.
Risultati attesi
- Per richieste di implementazione, un componente con un modello esplicito di composizione e stato.
- Per richieste di documentazione, una guida all’API del componente e ai comportamenti pertinenti.
- Un piano appropriato di packaging o registro quando la distribuzione rientra nella richiesta.
Dal brief alla revisione
- 01Definisci il contratto del componente
Decidi se l’attività riguarda una primitiva, un componente, un blocco o un template. Definisci l’interfaccia pubblica e i contesti in cui i chiamanti lo comporranno.
- 02Leggi le guide tecniche pertinenti
Leggi state.mdx per il comportamento controllato e non controllato, composition.mdx per il modello di composizione pubblico e accessibility.mdx per tastiera e focus. Consulta types.mdx e styling.mdx per l’implementazione. Aggiungi i riferimenti a polimorfismo o as-child solo se i chiamanti necessitano di questi pattern API.
- 03Implementa e documenta l’interfaccia
Collega stato e presentazione attraverso l’API scelta. Spiega l’uso previsto e scegli npm, un registro o un altro canale documentato solo quando serve.