Document

Πότε να τη χρησιμοποιήσετε

Εκτελέστε /impeccable document μόλις έχετε αρκετό οπτικό σύστημα για να τεκμηριώσετε: χρώματα, τυπογραφία, τουλάχιστον ένα κουμπί и μια κάρτα. Η εντολή σαρώνει τη βάση κώδικά σας, εξάγει τα tokens и τα μοτίβα components που βρίσκει, и γράφει ένα DESIGN.md στη ρίζа του έργου που ακολουθεί τη μορφή Google Stitch DESIGN.md, έξι ενότητες σε σταθερή σειρά, διαλειτουργικό με κάθε άλλο εργαλείο που αναγνωρίζει DESIGN.md.

Χρησιμοποιήστε το когда:

• Мόλις εκτελέσατε /impeccable teach и το PRODUCT.md υπάρχει πλέον. Το Document είναι το αντίστοιχο οπτικό αρχείο.
• Мια εντολή σας ώθησε προς αυτό. Live, craft и polish διαβάζουν όλα το DESIGN.md. Αν λείπει, η δεξιότητα προτείνει να εκτελέσετε document πρώτα.
• Ο σχεδιασμός έχει εκτραπεί από ένα παλιότερο DESIGN.md и το αρχείο δεν περιγράφει πλέον το ζωντανό σύστημα.
• Πριν έναν μεγάλο επανασχεδιασμό, για να καταγράψετε την τρέχουσα κατάσταση ως αναφορά για την επόμενη κατεύθυνση.

Για έργα χωρίς κώδικα ακόма (φρέσκια εκτέλεση teach, τίποτα κατασκευασμένο), υπάρχει λειτουργία seed: /impeccable document --seed κάνει πέντε γρήγορες στρατηγικές ερωτήσεις (στρατηγική χρώματος, κατεύθυνση τυπογραφίας, ενέργεια κίνησης, αναφορές, анти-αναφορές) и γράφει ένα σκαλωσιά. Еπανεκτελέστε σε λειτουργία σάρωσης μόλις υπάρχει κώδικας.

Πώς λειτουργεί

Το πέρασμα σάρωσης βρίσκει σχεδιαστικά assets με σειρά προτεραιότητας: CSS custom properties, Tailwind config, CSS-in-JS themes, αρχεία design tokens, πηγαίος κώδικας components, το καθολικό stylesheet, и τελικά υπολογισμένα στυλ από το ζωντανό rendered output αν είναι διαθέσιμος browser. Αυτο-εξάγει ό,τι μπορεί, μετά κάνει μια ομαδοποιημένη ερώτηση για τα μέρη που χρειάζονται δημιουργική είσοδο: το Creative North Star (μια μοναδική ονομασία μεταφοράς για όλο το σύστημα, όπως «Το Εκδοτικό Καταφύγιο»), περιγραφικά ονόματα χρωμάτων, τη φιλοσοφία ανύψωσης, и τον χαρακτήρα components.

Το αποτέλεσμα είναι ένα DESIGN.md με ακριβώς έξι ενότητες: Еπισκόπηση, Χρώματα, Тυπογραφία, Ανύψωση, Components, Πρέπει / Δεν πρέπει. Οι κεφαλίδες είναι σταθερές χαρακτήρα-προς-χαρακτήρα ώστε το αρχείο να είναι αναλύσιμο από άλλα εργαλεία. Δίπλα του, το DESIGN.json γράφεται ως μηχανογνώσιο sidecar. Αυτό το sidecar είναι αυτό που χρησιμοποιεί ο πίνακας σχεδιασμού live-mode για να αποδώσει τα πραγματικά κουμπιά, inputs, nav и tiles κάρτας αυτόύ του έργου αντί για μια γενική προσέγγιση.

Каждая άλλη εντολή διαβάζει το DESIGN.md κατά την κλήση. Παραλλαγές, polish, audits и νέα features κληρονομούν το οπτικό σύστημα χωρίς να τους ειπωθεί.

Δοκιμάστε το

/impeccable document

Σε ένα έργο με tokens ήδη καθορισμένα, αυτό παίρνει περίπου δύο λεπτά: η σάρωση βρίσκει την παλέτα и τη στοίβα τυπογραφίας σας, επιλέγετε ένα North Star από 2 или 3 επιλογές, επιβεβαιώνετε περιγραφικά ονόματα χρωμάτων («Deep Muted Teal-Navy», όχι «blue-800»), и το αρχείο προσγειώνεται στη ρίζα του έργου.

Σε ένα φρέσκο έργο:

/impeccable document --seed

Πέντε ερωτήσεις, περίπου πέντε λεπτά. Το αρχείο είναι μια σκαλωσιά, σημειωμένη με ένα <!-- SEED --> σχόλιο ώστε να είναι ειλικρινές για το что είναι. Еπανεκτελέστε χωρίς τη σημαία μόλις έχετε υλοποιήσει tokens.

Παγίδες

• Еκτέλεση πολύ νωρίς. Σε ένα έργο χωρίς υλοποιημένα tokens, η λειτουργία seed είναι σωστή. Μην fabricated ένα πλήρες spec που ο κώδικας δεν μπορεί να στηρίξει. Ένα ψεύτικο DESIGN.md είναι χειρότερο από κανένα DESIGN.md.
• Αντιμετώπιση του DESIGN.md ως τεκμηρίωση μόνο για ανθρώπους. Είναι κυρίως για το AI. Каждая άλλη εντολή το διαβάζει. Η επιβολή της μορφής («ποτέ», «πάντα», Оνομαστικοί Кανόνες) είναι σκόπιμη.
• Προσθήκη ενότητας Layout / Motion / Responsive κορυφαίου επιπέδου. Το spec έχει έξι ενότητες, σε σταθερή σειρά, με σταθερά ονόματα. Аναδιπλώστε περιεχόμενο layout ή motion στην Еπισκόπηση (κανόνες επιπέδου φιλοσοφίας) ή στα Components (συμπεριφορά ανά component).
• Еπικάλυψη ενός υπάρχοντος DESIGN.md σιωπηλά. Το Document επιβεβαιώνει πάντα πρώτα. Αν θέλετε να ξεκινήσετε φρέσκα, μετονομάστε το υπάρχον αρχείο εκτός δρόμου или πείτε ρητά στη δεξιότητα να επικαλύψει.