GitHub Spec Kit — ο βοηθός δουλεύει με προδιαγραφή, όχι με έμπνευση

Τι κάνει

Ζητάς από τον βοηθό σου να χτίσει μια λειτουργία. Εκείνος αρχίζει να γράφει κώδικα, και μισή ώρα μετά καταλαβαίνεις ότι έλυσε άλλο πρόβλημα. Αυτό το λένε έτσι: πας με το ένστικτο, χωρίς χαρτί.

Το Spec Kit είναι το επίσημο εργαλείο της GitHub για το αντίθετο. Πρώτα γράφεις τι θέλεις. Μετά πώς θα το φτιάξεις. Μετά σε ποιες δουλειές σπάει. Και μόνο στο τέλος γράφεται κώδικας. Κάθε βήμα αφήνει πίσω του ένα αρχείο κειμένου που τροφοδοτεί το επόμενο. Ο βοηθός δεν μαντεύει· διαβάζει.

Η βασική ροή έχει πέντε σταθμούς: Specify, Plan, Tasks, Implement, Converge. Δηλαδή, τι θέλω, πώς θα το κάνω, σε ποιες δουλειές σπάει, ας το φτιάξω, και μετά κοίτα τι έμεινε. Δίπλα σε αυτά υπάρχουν δύο προαιρετικές επεκτάσεις, μία για να διορθώσεις ένα σφάλμα και μία για να κρίνεις αν μια ιδέα αξίζει τον κόπο (τεκμηρίωση).

Δεν είναι πρόγραμμα που γράφει κώδικα. Είναι σετ από οδηγίες και πρότυπα, που τα διαβάζει ο βοηθός μέσα στο πρόγραμμα που ήδη χρησιμοποιείς. Στην πράξη εγκαθιστά μια σειρά από αρχεία οδηγιών. Αυτά τα αρχεία λέγονται skills: φορτώνονται μόνα τους όταν ο βοηθός τα χρειαστεί, χωρίς να του το ζητήσεις.

Για ποιον είναι

Για όποιον έχει βαρεθεί να εξηγεί το ίδιο πράγμα από την αρχή σε κάθε νέο αίτημα. Το Spec Kit βάζει ένα χαρτί μπροστά, πριν χαλάσεις ώρες κώδικα.

Είναι χρήσιμο σε μεγάλες λειτουργίες, σε καινούργια project, και σε δουλειά που θα την ξαναπιάσεις μετά από εβδομάδες και θα θέλεις να θυμηθείς τι είχες στο μυαλό σου.

Δεν αξίζει για μια αλλαγή χρώματος. Εκεί το χαρτί ζυγίζει περισσότερο από τη δουλειά.

Εγκατάσταση

Θέλεις Python 3.11 ή νεότερη, το uv, και έναν βοηθό από τη λίστα. Το εργαλείο λέγεται specify-cli.

uv tool install specify-cli

Έλεγξε ότι μπήκε:

specify --version

Στη δική μας δοκιμή γύρισε «specify 1.1.3». Υπάρχει και έλεγχος ετοιμότητας:

specify check

Μας απάντησε «Specify CLI is ready to use!».

Μετά φτιάχνεις project. Εδώ είναι το σημείο που μπερδεύει κόσμο: το κλειδί του βοηθού δεν είναι πάντα αυτό που περιμένεις. Για το Cursor, για παράδειγμα, το κλειδί είναι cursor-agent, όχι cursor (λίστα ενσωματώσεων).

Αν το εργαλείο του βοηθού δεν είναι εγκατεστημένο στο μηχάνημα, το init διαμαρτύρεται. Τότε προσθέτεις μια σημαία:

specify init my-project --integration claude --ignore-agent-tools

Το –ignore-agent-tools λέει «θέλω απλώς τα αρχεία, μη με ρωτήσεις αν έχω τον agent». Το χρειαστήκαμε στ’ αλήθεια, γιατί εδώ δεν υπάρχει Claude Code CLI.

Προσθήκη δεύτερου βοηθού

Αν θέλεις το ίδιο project να το δουλεύουν πολλοί βοηθοί, τους προσθέτεις στον ίδιο φάκελο. Μοιράζονται το .specify/ και τα specs/.

specify integration install codex

specify integration install cursor-agent

specify integration status

Χρήση σε κάθε LLM

Η εγκατάσταση τελείωσε. Τώρα ανοίγεις τον βοηθό μέσα στον φάκελο του project και καλείς τα βήματα με τη σειρά. Το πώς τα καλείς αλλάζει από βοηθό σε βοηθό, και αυτό είναι το κομμάτι που συνήθως λείπει από τα άρθρα.

Claude Code

Πρώτα φτιάχνεις το project με το κλειδί claude.

specify init my-project --integration claude

Μετά ανοίγεις το Claude Code μέσα στον φάκελο. Τα βήματα τα ζητάς γράφοντας στη συνομιλία, ένα-ένα:

/speckit-constitution

/speckit-specify

/speckit-plan

/speckit-tasks

/speckit-implement

Τα skills κάθονται στον φάκελο .claude/skills/ του project, δέκα στον αριθμό. Το constitution το τρέχεις μία φορά στην αρχή. Μετά το specify γράφει την προδιαγραφή, το plan το τεχνικό σχέδιο, το tasks τη λίστα δουλειών, το implement τον κώδικα. Πρόσεξε κάτι: είναι skills, όχι εντολές τερματικού. Τα γράφεις στη συνομιλία του βοηθού, όχι στο μαύρο παράθυρο.

Codex CLI

Ίδια ιδέα, άλλο κλειδί.

specify init my-project --integration codex

Εδώ αλλάζουν δύο πράγματα. Τα skills γράφονται στον φάκελο .agents/skills/ αντί για .claude/skills/. Και τα καλείς με δολάριο αντί για κάθετο:

$speckit-specify

Δηλαδή στο Codex γράφεις $speckit-specify, $speckit-plan, $speckit-tasks, $speckit-implement. Η ουσία ίδια, η σύνταξη διαφέρει.

Cursor

Και εδώ η παγίδα. Το Cursor δεν μπαίνει με τη λέξη cursor.

specify init my-project --integration cursor-agent

Τα skills γράφονται στον φάκελο .cursor/skills/ του project. Τα καλείς με κάθετο, όπως στο Claude Code:

/speckit-specify

Το Cursor είναι πρόγραμμα με παράθυρο, όχι τερματικό. Γι’ αυτό δεν χρειάζεται να είναι εγκατεστημένο κάποιο εργαλείο γραμμής εντολών για να δουλέψει η ενσωμάτωση· αρκεί ο φάκελος του project.

Πού κερδίζει, πού χάνει

Κερδίζει στην τάξη. Πριν γραφτεί μία γραμμή κώδικα, υπάρχει χαρτί με το τι ζήτησες. Τα λάθη φαίνονται νωρίς, όταν η διόρθωσή τους είναι φτηνή.

Κερδίζει στο ότι δεν σε κλειδώνει. Η τεκμηρίωση μετρά 38 ενσωματώσεις, και υπάρχει ένα κλειδί generic για ό,τι δεν είναι στη λίστα. Ξεκινάς με έναν βοηθό και προσθέτεις άλλον αύριο.

Κερδίζει και στην ωριμότητα. Το αποθετήριο έχει 140.656 αστέρια, 12.594 forks και άδεια MIT, με τελευταία έκδοση την v1.1.3 στις 9 Οκτωβρίου 2026 (εκδόσεις).

Χάνει στην πρώτη επαφή. Δέκα skills, πέντε στάδια και δύο επεκτάσεις είναι λεξιλόγιο που θέλει χρόνο για να το συνηθίσεις.

Χάνει στη μικρή δουλειά. Όταν αλλάζεις ένα χρώμα, η διαδικασία ζυγίζει περισσότερο από τη δουλειά.

Και χάνει όταν βιάζεσαι. Η ροή σε σταματά για έλεγχο σε κάθε βήμα. Κάποιοι το νιώθουν σαν φρένο.

Δοκιμή

Έτρεξε στ’ αλήθεια, σε αυτό το μηχάνημα, με uv.

Η εγκατάσταση πέρασε, και το specify –version γύρισε «specify 1.1.3». Το specify check απάντησε «Specify CLI is ready to use!».

Μετά έτρεξε πραγματικό init με το Claude ως ενσωμάτωση:

specify init demo-app --integration claude --non-interactive --ignore-agent-tools

Το –ignore-agent-tools χρειάστηκε γιατί εδώ δεν υπάρχει Claude Code CLI. Πέρασε. Ο φάκελος demo-app γέμισε με .claude/skills/ που περιέχει δέκα φακέλους skills, ανάμεσά τους τα speckit-specify, speckit-plan, speckit-tasks, speckit-implement και speckit-constitution. Δίπλα τους, το .specify/templates/ με πέντε πρότυπα: spec, plan, tasks, checklist, constitution. Τα μέτρησα: δέκα και πέντε.

Τι δεν τρέξαμε, και το λέω καθαρά. Δεν τρέξαμε ολόκληρο κύκλο από specify ως implement μέσα σε βοηθό. Δεν τρέξαμε ενσωμάτωση σε Codex ή Cursor. Ό,τι γράφω για τα βήματα μέσα σε κάθε βοηθό και για τις συντάξεις τους είναι από την τεκμηρίωση, όχι δοκιμασμένο στα χέρια μας.

Ετυμηγορία

Το Spec Kit λύνει ένα πρόβλημα που όλοι νιώθουμε και λίγοι ονομάζουν: ο βοηθός απαντά γρήγορα, αλλά όχι πάντα σε αυτό που ρώτησες. Εδώ η ροή μπαίνει μπροστά από την ταχύτητα, και το κάνει σωστά.

Είναι ώριμο, ενεργό, δωρεάν, με άδεια MIT. Το ότι το συντηρεί η ίδια η GitHub μετράει για την εμπιστοσύνη.

Το τίμημα είναι ο χρόνος εκμάθησης. Δύο-τρεις δουλειές θα περάσουν μέχρι να σου γίνει δεύτερη φύση.

Αν δουλεύεις με Claude Code, Codex ή Cursor, και χτίζεις πράγματα που δεν θα θυμάσαι σε δύο μέρες, δοκίμασέ το.

Βαθμολογία: 8.8/10.

Πηγές: https://github.com/github/spec-kit · https://github.github.io/spec-kit/ · https://github.com/github/spec-kit/blob/main/docs/reference/integrations.md · https://github.com/github/spec-kit/releases