Μετάβαση στο κύριο περιεχόμενο

Skills και εργαλεία

Χρησιμοποιήστε αυτό το playbook όταν ρυθμίζετε ή προσαρμόζετε skills και εξωτερικά εργαλεία.

Προτεινόμενα skills​

Context7 (τεκμηρίωση βιβλιοθηκών)​

Για ενημερωμένη τεκμηρίωση βιβλιοθηκών.

npx skills add https://github.com/intellectronica/agent-skills --skill context7

Playwright CLI​

Χρησιμοποιήστε το playwright-cli για αυτοματοποίηση προγράμματος περιήγησης (πλοήγηση, αλληλεπίδραση, στιγμιότυπα οθόνης, δοκιμές, εξαγωγή δεδομένων).

Όταν χρησιμοποιείτε το playwright-cli για επαλήθευση του UI του αποθετηρίου, μη σταματάτε μετά από μία μηχανή. Εκτελέστε τη σχετική ροή και στις τρεις βασικές μηχανές προγραμμάτων περιήγησης:

  • chrome για το Blink
  • firefox για το Gecko
  • webkit για κάλυψη Safari/WebKit

Χρησιμοποιήστε ξεχωριστές ονομασμένες συνεδρίες ανά μηχανή ώστε τα ευρήματα να μένουν απομονωμένα, αλλά εκτελέστε αυτές τις συνεδρίες διαδοχικά. Μόνο μία συνεδρία προγράμματος περιήγησης Playwright μπορεί να είναι ενεργή κάθε στιγμή σε ολόκληρο το μηχάνημα, επειδή ο πόρος που διεκδικείται είναι η RAM και η CPU του μηχανήματος και όχι το αποθετήριο. Ανοίγετε και κλείνετε συνεδρίες μέσω του ./scripts/pw-session.sh· αυτό κρατά το κοινό κλείδωμα, ώστε οι ταυτόχρονοι πράκτορες να αναβάλλουν και να επαναλαμβάνουν την εργασία στο πρόγραμμα περιήγησης αντί να κορεννύουν το μηχάνημα. Αν παραλείψετε σκόπιμα μια μηχανή, καταγράψτε τον λόγο.

Κατά τη διάρκεια των επαναλήψεων, χρησιμοποιήστε μόνο Chrome/Blink. Εκτελέστε την πλήρη ακολουθία Chrome, Firefox και WebKit μία φορά, όταν η αλλαγή είναι έτοιμη για τελική επαλήθευση. Επαναχρησιμοποιήστε τη συνεδρία κάθε μηχανής για desktop και mobile αλλάζοντας το μέγεθος του παραθύρου, κλείστε τη σε καθαρισμό τύπου finally και μόνο τότε ανοίξτε την επόμενη μηχανή.

./scripts/pw-session.sh open verify-chrome https://bitsocial.localhost --browser=chrome
playwright-cli -s=verify-chrome snapshot
./scripts/pw-session.sh close verify-chrome

Όταν η θέση είναι κατειλημμένη, η open τερματίζει με κωδικό 75· περιμένετε με ./scripts/pw-session.sh open --wait[=SECONDS] ... (προεπιλογή 300 δευτερόλεπτα) αντί να ξαναδοκιμάζετε χειροκίνητα. Ένα κλείδωμα που άφησε πίσω της μια διακοπείσα ροή εργασίας ανακτάται αυτόματα, επειδή η open απελευθερώνει κάθε θέση της οποίας το καταγεγραμμένο πρόγραμμα περιήγησης δεν εκτελείται πλέον. Ελέγξτε ποιος κατέχει τη θέση με ./scripts/pw-session.sh status· το release <session> είναι έσχατη λύση για τη σπάνια περίπτωση όπου το status δεν μπορεί να επαληθεύσει την κατάσταση του προγράμματος περιήγησης.

npm install -g @playwright/cli@latest
playwright-cli install --skills

Θέσεις εγκατάστασης των skills:

  • .cursor/skills/playwright-cli/
  • .claude/skills/playwright-cli/

Vercel React Best Practices​

Για βαθύτερη καθοδήγηση σχετικά με την απόδοση σε React/Next.

npx skills add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practices

Find Skills​

Ανακαλύψτε και εγκαταστήστε skills από το ανοιχτό οικοσύστημα.

npx skills add https://github.com/vercel-labs/skills --skill find-skills

Σκεπτικό της πολιτικής για MCP​

Αποφύγετε τους MCP servers του GitHub και τους MCP servers προγράμματος περιήγησης σε αυτό το έργο, επειδή προσθέτουν σημαντικό κόστος σε σχήματα εργαλείων και σε context.

  • Λειτουργίες GitHub: χρησιμοποιήστε το gh CLI.
  • Λειτουργίες προγράμματος περιήγησης: χρησιμοποιήστε το playwright-cli.

Διαθεσιμότητα μοντέλων​

  • Το composer-2 είναι διαθέσιμο μόνο στο Cursor. Μην το ρυθμίζετε κάτω από τα .claude/ ή .codex/.
  • Το Codex δεν τεκμηριώνει ψευδώνυμο μοντέλου latest. Τα υποβεβλημένα TOML προσαρμοσμένων πρακτόρων κάτω από το .codex/**/agents/*.toml παραλείπουν τόσο το model όσο και το model_reasoning_effort, ώστε να κληρονομούν τις τρέχουσες ρυθμίσεις της γονικής συνεδρίας.