mirror of
https://github.com/merlinhu1/codex-game-studio.git
synced 2026-08-25 07:54:34 +02:00
e06453bcab
* docs: remove stale research design note * feat: prune maintainer artifacts during init * docs: expand localized README guides --------- Co-authored-by: MerlinH <merlinh221@gmail.com>
78 lines
5.4 KiB
Markdown
78 lines
5.4 KiB
Markdown
# Codex Game Studio
|
|
|
|
**Μετατρέψτε μια συνεδρία Codex σε δομημένο, local-first στούντιο παιχνιδιών.**
|
|
|
|
[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
|
|
|
|
Το Codex Game Studio είναι ένα TypeScript CLI. Δημιουργεί για έργα παιχνιδιών ένα workspace έτοιμο για Codex και αποθηκεύει role prompts, workflow prompts, αρχεία έργου, κατάσταση εργασιών και στοιχεία validation σε κανονικά αρχεία που ελέγχονται στο Git.
|
|
|
|
Δεν είναι game engine ούτε hosted project manager. Στόχος του είναι να δώσει στο Codex ένα καθαρότερο συμβόλαιο εργασίας, ενώ οι δημιουργικές αποφάσεις και το τελικό review μένουν στους ανθρώπους.
|
|
|
|
## Γρήγορη εκκίνηση
|
|
|
|
Χρειάζεται Node.js 24 ή νεότερο. Το `run <role>` χρειάζεται Codex CLI.
|
|
|
|
```sh
|
|
git clone git@github.com:merlinhu1/codex-game-studio.git signal-cartographer
|
|
cd signal-cartographer
|
|
npm install
|
|
npm run build
|
|
|
|
./codex-game-studio init --name "Signal Cartographer" --engine godot --mode prototype --non-interactive \
|
|
--concept "A compact puzzle game about routing trains through haunted switchyards"
|
|
|
|
./codex-game-studio status
|
|
./codex-game-studio validate
|
|
```
|
|
|
|
Πριν τρέξετε πραγματικά το Codex, μπορείτε να δείτε το role prompt:
|
|
|
|
```sh
|
|
./codex-game-studio run producer \
|
|
"Create the initial market overview." --print-prompt
|
|
```
|
|
|
|
Αναλυτικές εντολές υπάρχουν στο αγγλικό [User Guide](../user-guide.md).
|
|
|
|
## Γιατί υπάρχει
|
|
|
|
Ένα κενό AI coding chat είναι ευέλικτο, αλλά η ανάπτυξη παιχνιδιών χρειάζεται επαναλήψιμη δομή στούντιο:
|
|
|
|
- Οι producers χρειάζονται milestones, handoffs και release checks.
|
|
- Οι designers χρειάζονται GDD, system specs, player journeys και tuning loops.
|
|
- Οι engineers χρειάζονται σαφώς οριοθετημένα implementation prompts και validation gates.
|
|
- Art, QA, audio, localization και live ops χρειάζονται επίσης δικό τους context.
|
|
- Οι reviewers χρειάζονται αρχεία που ελέγχονται στο Git, όχι αποφάσεις χαμένες στο ιστορικό του chat.
|
|
|
|
Το Codex Game Studio μετατρέπει αυτή τη δομή σε τοπικά project artifacts που μπορεί να διαβάσει το Codex και να ελέγξουν άνθρωποι.
|
|
|
|
## Τι παίρνετε
|
|
|
|
| Δυνατότητα | Τι σημαίνει |
|
|
| --- | --- |
|
|
| Τοπικό project scaffolding | Δημιουργεί deterministic game workspace στη ρίζα του τρέχοντος repository. |
|
|
| Codex-native ρόλοι στούντιο | Παρέχει εστιασμένα prompts για production, design, engineering, art, QA, localization και release. |
|
|
| Workflow prompts | Παρέχει επαναχρησιμοποιήσιμα prompts για market, analysis, specs, handoffs, ship checks και UI review. |
|
|
| Engine overlay | Προσθέτει context για Godot, Unity ή Unreal χωρίς να κάνει το project engine wrapper. |
|
|
| Κατάσταση εργασιών σε αρχεία | Αποθηκεύει tasks, locks και run metadata κάτω από `.codex/**`. |
|
|
| Έλεγχος πριν την εκτέλεση | Dry-run και εκτύπωση prompt επιτρέπουν έλεγχο πριν ενεργήσει το Codex. |
|
|
| Αυστηρό validation | Εντοπίζει παλιά generated files, κακά metadata, ελλιπή assets και drift προς μελλοντικές λειτουργίες. |
|
|
|
|
## Διαβάστε περισσότερα
|
|
|
|
| Ανάγκη | Έγγραφο |
|
|
| --- | --- |
|
|
| Εγκατάσταση, εντολές, workflows και validation | [User Guide](../user-guide.md) |
|
|
| Σενάρια χρήσης | [Examples](../examples/README.md) |
|
|
| Πλήρης χάρτης τεκμηρίωσης | [Docs Index](../README.md) |
|
|
|
|
## Κατάσταση έργου
|
|
|
|
Το Codex Game Studio υποστηρίζει σήμερα deterministic project scaffolding, εκτέλεση ρόλων Codex, rendering workflow prompts, file-backed task orchestration και repository/project validation.
|
|
|
|
Planner ή `next` commands, telemetry, hosted orchestration, απεριόριστη παραλληλία, forced output ownership και παραγωγή `CODEX.md` / `project_orchestrator.md` είναι εκτός του τρέχοντος ορίου προϊόντος.
|
|
|
|
## Άδεια
|
|
|
|
Το Codex Game Studio χρησιμοποιεί MIT License. Δείτε [`LICENSE`](../../LICENSE).
|