Communitygithub.com

ProdaZhang/aigd

Spieledesign mit KI brainstormen, die Ergebnisse direkt an eine andere KI zur Umsetzung übergeben – mit deterministischen Konsistenzprüfungen.

Was ist aigd?

AIGD (AI Game Design) ist eine portable Methodik zur KI-gestützten Spielentwicklung, die den gesamten Prozess von der ersten Idee über das Systemdesign und Playtest-Iterationen bis hin zur finalen Übergabe abdeckt. Das Kernstück ist ein zentrales Projektrückgrat (Spine) bestehend aus Projektcharta und Manifest, das als alleinige Quelle der Wahrheit dient und von allen Sub-Skills gelesen und aktualisiert wird. Die Methodik umfasst sechs spezialisierte Sub-Skills: Konzeptentwicklung, Systemdesign, Iteration, Handoff, Sync und UI-Capture, die durch einen Orchestrator koordiniert werden. Das Ziel ist ein plattformunabhängiges Übergabepaket, das eine andere KI direkt in Code umsetzen kann – die eigentliche Implementierung des Tech-Stacks bleibt bewusst ausgegliedert. Unterstützt wird der Workflow durch deterministische Prüfungen, Versionsverwaltung, Änderungsprotokolle und definierte Zustandsübergänge inklusive Rollback-Mechanismen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aigd

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

AIGD · Orchestrator

AIGD = AI Game Design (KI-gestütztes Spieledesign). Ein portables Methodik-Paket für die KI-gestützte Spielentwicklung: Brainstorming → Systemdesign → Playtest-Iteration → Finalisierung & Übergabe. Es erzeugt ein Übergabepaket (plattformunabhängig), das „eine andere KI direkt weiterentwickeln kann“. Die Implementierung (Auswahl eines Tech-Stacks zum Schreiben von Client/Server) ist nicht Teil dieses Pakets und bleibt einem zukünftigen, dedizierten Landing-Skill vorbehalten.

Status: v0 (Pre-Release) – Ende-zu-Ende validiert (Live-Demos + der ausführbare examples/-Walkthrough in der Repository-README). patterns/ ist ein Starterpaket, das ständig wächst (siehe references/README.md).

Kernmodell (Details siehe references/)

  • Zwei Ebenen: ① Die lebende Projektebene (Rückgrat) – project charter (Konzept / Plattform / Zielnutzer / Genre / Stil / Namenskonventionen) + manifest (Systemliste + Abhängigkeitsgraph + ebenenübergreifender Index + Freeze-Ledger + Nummernbereichsregister), kontinuierlich überarbeitet; ② Die produktionsschleife pro System.
  • Zentralisierte Quelle der Wahrheit: Aufzählungen / Nummerierungen / Schnittstellenverträge / Konfigurationstabellen gehören zur Projektebene; Doppelte Kopien (systemweit + global): Akzeptanz / Ressourcenbedarf / Prototyp; Nur auf Systemebene: Regeln / Backend-Algorithmen.
  • Jeder Vorgang: Rückgrat lesen → Arbeit erledigen → Rückgrat aktualisieren. Entdeckungen auf unterer Ebene (neues System / neue Abhängigkeit / neue Aufzählung / geändertes Konzept) werden nach oben in die obere Ebene zurückgeschrieben.
  • Methodische Quelle der Wahrheit: references/methodology.md, references/README.md.

Routing: Sub-Skill nach „Was möchtest du diesmal tun“ auswählen

Was möchtest du tunSub-Skill
Konzept / Kernspielschleife / Plattform / Zielnutzer / in Systeme aufteilenaigd-concept
Ein System entwerfen (Regeln + Konfigurationstestdaten + HTML-Prototyp)aigd-system
Ein System nach dem Playtest optimieren (Regeln/Konfiguration/Prototyp, wiederholbar)aigd-iterate
Ein System finalisieren → Vertrag / Akzeptanz / Client-Server-Dokumente / Designer-Akzeptanz-Checklisteaigd-handoff
Globale Spezifikation / Gesamtprototyp / Implementierungs-Master-Guide zurückschreiben; Änderungen an gemeinsamen Elementen als Überprüfung markierenaigd-sync
UI-Screenshot → UI-DSL (Wissensbasis für UI-Paradigmen aufbauen, für Design-Zeit-Recherche & Referenz)aigd-ui-capture

Verwendung

  1. Zuerst das Rückgrat lesen (Projektcharta + Manifest), um zu beurteilen: Welchen Schritt hat das Projekt erreicht, in welchem Zustand befindet sich das diesmalige System, was fehlt?
  2. Kein Rückgrat → Projekt mit aigd-concept starten (Rückgrat aufbauen).
  3. Den passenden Sub-Skill auswählen und mit dem Skill-Tool aufrufen; jeder Sub-Skill liest und schreibt dasselbe Rückgrat, hält es konsistent und wiedereintrittsfähig (kann sitzungsübergreifend / von einer anderen KI fortgesetzt werden).
  4. Typischer Pfad: Konzept (einmalig) → pro System {System → iterieren… (wiederholt) → Handoff finalisieren} → Sync (kontinuierlich). Iterate geht nicht direkt in Sync – Sync-Zulassung erfordert, dass das System bereits Final ist, und nur Handoff kann finalisieren; die Reihenfolge ist nicht erzwungen, nach Bedarf routen.

Wenn kein Rückgrat existiert (erste Verwendung in einem Projekt, project charter / manifest existieren noch nicht): „Rückgrat lesen“ liefert nichts → direkt zu aigd-concept routen, um das Rückgrat zu starten; das ist normal, kein Fehler.

Start-Selbstprüfung (wird bei jedem Eintritt in /aigd ausgeführt – proaktiv vorantreiben, nicht darauf warten, dass der Nutzer rät)

  1. Existiert das Rückgrat? Ja → project-charter.md + manifest.md lesen; Nein → zu aigd-concept routen, um das Projekt zu starten.
  2. Welche Systeme haben Status ≠ Final? Auflisten, den Nutzer fragen, welches diesmal vorangetrieben werden soll.
  3. Gibt es Recheck-Systeme? Daran erinnern, zuerst zu überprüfen (ein gemeinsames Element hat sich geändert) → zu aigd-sync routen, um zu klären (Überprüfung bestanden → zurück zu Final / fehlgeschlagen → zurückgeworfen).
  4. Nummernbereichskonflikte / Zyklen im Abhängigkeitsgraphen? Prüfen und melden.

Zustandsübergänge (nichtlinear · mit Rollback)

concept ──→ system design ⇄ playtest iteration ──→ finalize ──→ integration
 ▲             │              │            │(Rückwurf)
 │             │              │            ▼
 │             └─Grenze falsch gezeichnet─┴────→ zurück zu playtest / zurück zu concept
 └────────── Integration findet Inkompatibilität / erneute Aufteilung nötig ──────────┘
  • Jeder Rückwurf / erneute Aufteilung zeichnet einen Eintrag im Manifest „Rollback-Log“ auf und sucht gemäß den „Rückwurf-Regeln“ rückwärts depended-on-by, wobei bereits finalisierte nachgelagerte Systeme als Recheck markiert werden (siehe aigd-handoff / aigd-sync).
  • Vorlagen: references/templates/ (Projektcharta / Manifest / Implementierungs-Master-Guide, stark typisiert).

Paketstruktur (gesamtes Paket installieren, nicht aufteilen)

aigd (dieser Orchestrator, enthält die references/-Methodik und Vorlagen) + 6 Sub-Skills aigd-concept / system / iterate / handoff / sync / ui-capture, auf derselben Ebene im Skills-Verzeichnis dieser Umgebung installiert (gemäß dem Host-Agenten, z. B. Claude Codes .claude/skills/). Sub-Skill-Texte verwenden ../aigd/references/, um die Methodik abzurufen – aigd/ muss auf derselben Ebene existieren (aigd-ui-capture greift ebenfalls über ../aigd/references/ui-dsl-spec.md und scripts/ zu). Einzelne Quelle der Wahrheit, nicht einzeln kopieren; falls du es später unabhängig verteilen möchtest, upgrade es zu einem Plugin (siehe references/README.md „Packaging & Portability“).

Empfehlungen für die Projektumgebung

  • Rückgrat-Dateien (project charter / manifest) und Design-Artefakte sollten unter Git/SVN-Verwaltung gestellt werden; der Orchestrator sollte vor jedem Vorgang einen Blick auf den Versionsstatus werfen.
  • CHANGELOG (Änderungsprotokoll) ergänzt die Versionsverwaltung: VCS zeichnet auf „was sich geändert hat“, CHANGELOG zeichnet auf „warum + welches Modell“ (diese Methodik ist ein KI-gestützter Ablauf, die Aufzeichnung des Modells hilft nachzuvollziehen, woher eine bestimmte Änderung stammt).

Abgrenzung

  • Reicht bis zu „ein Übergabepaket, das eine KI direkt weiterentwickeln kann“ (plattformunabhängig: Regeln / Vertrag / Konfiguration / Akzeptanz / Prototyp / Ressourcenbedarf).
  • Tech-Stack-Wahl und Client/Server-Implementierung = nachgelagert, nicht in diesem Paket.

Verwandte Skills