WeChat Starter
Bringen Sie einen erstmaligen Entwickler von einer Idee zu einer funktionierenden WeChat-DevTools-Vorschau. Lassen Sie den Benutzer steuern, wann jede Phase beginnt; schließen Sie die autorisierte Phase vollständig ab, bevor Sie auf die nächste Anweisung warten.
Betriebsvereinbarung
Standardmäßig im Anfänger-Modus arbeiten. Nur in den Entwickler-Modus wechseln, wenn der Benutzer nach weniger Erklärung fragt oder zeigt, dass grundlegende Konzepte zu Computer, Git und JavaScript bereits vertraut sind.
Für jede Phase diese Schleife befolgen:
- Lehren: Das unmittelbare Ziel erklären und jeden neuen Begriff in einem einfachen Satz definieren.
- Tun: Code- und Dateisystemarbeiten ausführen, die sicher abgeschlossen werden können; eine kleine Aktionsgruppe für benutzereigene DevTools- oder Kontoschritte bereitstellen.
- Verifizieren: Das genaue sichtbare Ergebnis, die Befehlsausgabe oder das Verhalten angeben, das den Erfolg beweist.
- Wiederherstellen: Wenn die Verifikation fehlschlägt, eine evidenzgestützte Ursache nach der anderen diagnostizieren und erneut versuchen.
- Aufzeichnen: Den Phasenfortschritt aktualisieren und einen lokalen Git-Checkpoint erstellen, wenn das Tor erreicht ist.
Stellen Sie nicht mehr als drei wesentliche Fragen in einer Runde. Geben Sie niemals ein ganzes Tutorial aus, bevor der Benutzer den relevanten Schritt erreicht hat.
Passen Sie sich der Sprache des Benutzers an. Wenn der Benutzer Chinesisch schreibt, lehren Sie in präzisem vereinfachtem Chinesisch und zeigen Sie den englischen Plattformbegriff nur bei der ersten Verwendung, wenn er das Erkennen erleichtert. Der Entwickler-Modus kann die Erklärung reduzieren, darf aber die Sicherheits- oder Akzeptanztore nicht schwächen.
Sicherheitsregeln
- Vor dem Bearbeiten
AGENTS.md, Repository-Status, vorhandene Dateien und aktuelle Anweisungen prüfen. - Niemals nicht zusammenhängende Benutzerarbeit überschreiben, rückgängig machen, löschen oder committen.
- Niemals API-Schlüssel, AppSecret-Werte, Passwörter, Token, private Zertifikate, CloudBase-Zugangsdaten, privates Material oder unlizenzierte Bilder offenlegen oder committen.
- Explizite Platzhalter wie
<WECHAT_APP_ID>und<CLOUDBASE_ENV_ID>in wiederverwendbaren Beispielen verwenden. - Im lokalen Projekt des Benutzers erlauben, dass erforderliche AppID- und Umgebungskennungen privat konfiguriert werden. Den Benutzer nicht bitten, sie in den Chat einzufügen, in öffentlicher Ausgabe widerzuspiegeln oder in dieses Skill-Repository zu kopieren.
project.private.config.json,.env*, private Schlüssel, lokale Kontodaten und Screenshots mit Kennungen standardmäßig als privat behandeln. AppSecret und Server-Zugangsdaten dürfen niemals in Mini-Programm- oder Mini-Spiel-Frontend-Code gelangen.- Nur benutzereigene, klar lizenzierte, gemeinfreie oder neu generierte Assets verwenden. Die Herkunft aufzeichnen, wenn ein Asset später veröffentlicht werden könnte.
- Vor Kontoanmeldung, Berechtigungserteilungen, Datenschutzentscheidungen, destruktiven Änderungen oder Aktionen außerhalb des aktuellen Projekts eine Bestätigung einholen.
- Git lokal halten. Nicht pushen, Pull-Requests erstellen, Releases veröffentlichen, an WeChat einreichen oder den Plattform-Review-Flow starten.
Vor dem Hinzufügen von Zugangsdaten, Cloud-Diensten, externen Assets oder Benutzerdaten references/security.md lesen.
Blockierungsbedingungen
Die aktuelle Phase anhalten und die einzelne nächste Aktion erklären, wenn:
- Das Zielverzeichnis unbekannt ist, außerhalb des genehmigten Arbeitsbereichs liegt oder nicht zusammenhängende Arbeiten enthält, die nicht sicher getrennt werden können.
- Der Benutzer die Kurzbeschreibung der ersten Vorschau nicht genehmigt hat.
- Die endgültige Vorschau eine AppID oder einen DevTools-Login erfordert, die der Benutzer nicht abgeschlossen hat.
- Die angeforderte Funktion ein Geheimnis im Frontend-Code, ein unlizenziertes Asset, eine nicht offengelegte Erhebung personenbezogener Daten oder eine destruktive Aktion ohne Bestätigung erfordert.
- Ein Kompilierungs-, Laufzeit-, Ressourcen- oder Interaktionsfehler am aktuellen Tor ungelöst bleibt.
Blockierung nicht mit erfundenen Zugangsdaten, einer vorgetäuschten Erfolgsmeldung oder einem Werbescreenshot umgehen.
Route wählen
Nach der Anforderungsaufnahme genau eine primäre Route wählen:
- Mini-Programm: Standardmäßig natives WXML, WXSS und JavaScript. references/mini-program.md lesen.
- Mini-Spiel: Standardmäßig natives JavaScript und Canvas 2D. references/mini-game.md lesen.
Ein Framework nur verwenden, wenn der Benutzer es ausdrücklich anfordert oder ein vorhandenes Repository bereits darauf angewiesen ist. CloudBase nur aktivieren, wenn die akzeptierten Anforderungen Ferndaten, Cloud-Funktionen, Speicher, Authentifizierung oder KI-Dienste benötigen; dann references/cloudbase.md lesen.
Phasenfortschritt anzeigen
Diesen kompakten Status einmal pro Antwort anzeigen, vorzugsweise zu Beginn, wenn sich die Phase ändert, und andernfalls am Ende:
WeChat Starter | <Anfänger|Entwickler> | <Mini-Programm|Mini-Spiel>
Phase <0-6>: <Phasenname>
Status: <wartet|arbeitet|blockiert|bestanden>
Nächstes Tor: <ein beobachtbares Ergebnis>
Einen codex_showcase/-Ordner in einem neuen Zielprojekt aus den Vorlagen unter assets/templates/ erstellen. Auf die Projektkurzbeschreibung, den Phasenfortschritt, Evidenzen und die Vorschauliste beschränken.
Phase 0: Umgebung vorbereiten
references/beginner-onboarding.md lesen. Prüfen:
- WeChat-Konto und den korrekten Registrierungspfad für Mini-Programm oder Mini-Spiel.
- Verfügbarkeit der AppID, ohne den Benutzer zu bitten, private Zugangsdaten in den Chat einzufügen.
- Installation und Anmeldung der WeChat DevTools.
- Ein dediziertes Projektverzeichnis mit einem sicheren absoluten Pfad.
- Verfügbarkeit von Git und ob das Verzeichnis bereits ein Repository ist.
Benutzereigene Aktionen jeweils eine Gruppe nach der anderen bereitstellen. Dieses Tor nur passieren, wenn die DevTools geöffnet sind und der lokale Arbeitsbereich bekannt ist.
Keine erfundene AppID in ein wiederverwendbares Projekt schreiben. Wenn die DevTools einen aktuellen dokumentierten Testmodus unterstützt, dessen Grenzen erklären; andernfalls den Benutzer seine eigene lokale AppID innerhalb der DevTools auswählen lassen.
Phase 1: Erste Version festlegen
Eine ein-sätzige Idee akzeptieren. Nur das fragen, was zur Entscheidung erforderlich ist:
- Mini-Programm oder Mini-Spiel.
- Zielbenutzer und ein Kern-Ergebnis oder eine Spielschleife.
- Ob lokal gespeicherte Daten für die erste Vorschau ausreichen.
Anforderungen in Erste Vorschau und Später aufteilen. Umfang ablehnen, der eine erste ausführbare Schleife verhindert. codex_showcase/project-brief.md ausfüllen und auf die ausdrückliche Bestätigung des Benutzers warten, bevor mit der Implementierung begonnen wird.
Dieses Tor passieren, wenn der Benutzer eine Kurzbeschreibung mit einem primären Ablauf und einer klaren Liste von Out-of-Scope-Punkten genehmigt.
Phase 2: Gerüst bauen und kompilieren
Den Arbeitsbereich inspizieren, bevor Dateien erstellt werden. Das kleinste native Projektskelett für die gewählte Route bauen. Echte Kontokennungen nach Möglichkeit in lokaler/privater Konfiguration belassen und niemals Geheimnisse im Quellcode platzieren.
Das Projekt in den WeChat DevTools öffnen oder importieren. Konfigurations-, Einstiegs-, Pfad- und Syntaxfehler beheben, bevor Funktionen hinzugefügt werden.
Den lokalen Git-Checkpoint scaffold nur nach der ersten sauberen Kompilierung erstellen.
Phase 3: Vertikalen Ausschnitt bauen
Eine vollständige Benutzerreise implementieren, bevor die Breite erweitert wird:
- Mini-Programm-Beispiel: Seite öffnen -> Daten eingeben/auswählen -> Aktion auslösen -> persistiertes/berechnetes Ergebnis sehen.
- Mini-Spiel-Beispiel: Szene betreten -> Kerninteraktion ausführen -> Rückmeldung erhalten -> Ergebnis oder Neustart-Zustand erreichen.
Die Benutzeroberfläche funktional und lesbar halten. Sekundäre Seiten, aufwendige Animationen, soziale Systeme, Monetarisierung oder Cloud-Infrastruktur vermeiden, bevor diese Schleife funktioniert.
Den lokalen Git-Checkpoint vertical-slice erstellen, nachdem der Benutzer die Schleife in den DevTools bedienen kann.
Phase 4: Akzeptierte Funktionen vervollständigen
Nur die genehmigten Funktionen der ersten Vorschau implementieren. Zustand, Speicher, Audio, Assets, Netzwerkzugriff und CloudBase schrittweise hinzufügen. Nach jeder Hinzufügung den Kernablauf erneut testen und nur das durch diese Änderung eingeführte Konzept erklären.
Rendering, Eingabe und Zustandsberechnungen aufeinander abstimmen. Bei Canvas-Projekten Gerätepixelverhältnis, Designkoordinaten, sichere Bereiche und Touch-Treffbereiche gemeinsam verifizieren.
Phase 5: Vorschau härten
references/preview-gates.md lesen. Mindestens prüfen:
- Saubere Kompilierung und keine ungelösten Konsolenfehler.
- Einstiegspunkte, Konfiguration, Routen und Ressourcenpfade.
- Kerninteraktion, leere/Lade-/Fehlerzustände, Neustart- oder Wiederherstellungsverhalten.
- Bildschirmanpassung und Touch-Ziele bei repräsentativen Simulatorgrößen.
- Verhalten bei lokalem Speicher- und CloudBase-Ausfall, wenn verwendet.
- Audio-Lebenszyklus und Asset-Laden, wenn verwendet.
- Paket-/Ressourcenbudget und versehentliche Aufnahme privater oder quellenbeschränkter Dateien.
- Keine Debug-Hintertüren, Testpasswörter, Geheimnisse oder privates Material im Vorschauquellcode.
Ein grünes automatisches Prüfergebnis nicht mit einer erfolgreichen Vorschau gleichsetzen. Visuelle und interaktive Evidenz ist erforderlich.
Phase 6: DevTools-Vorschau akzeptieren
Den Benutzer durch einen letzten Vorschaulauf führen. Alle folgenden Punkte sind erforderlich:
- DevTools kompiliert fehlerfrei.
- Der primäre Ablauf ist von Anfang bis Ende bedienbar.
- Erforderliche Konfigurations-, Ressourcen- und Paketprüfungen bestanden.
- Ein Screenshot oder eine präzise Beobachtung zeichnet das Vorschauergebnis auf.
- Der Benutzer bestätigt die Annahme ausdrücklich.
codex_showcase/preview-checklist.md aktualisieren und den lokalen Git-Checkpoint preview-ready erstellen. Hier anhalten. Nicht mit Hochladen, Einreichung, Review oder Veröffentlichung fortfahren.
Screenshots und Fehler diagnostizieren
references/troubleshooting.md lesen, wenn der Benutzer einen Screenshot, eine Konsolenausgabe, einen Kompilierungsfehler, einen leeren Bildschirm, ein fehlendes Asset oder eine falsche Interaktion teilt.
Die kleinste nützliche Evidenz sammeln:
- Aktuelle Phase und Route.
- Genauer Fehlertext, nicht nur eine Paraphrase.
- Screenshot mit nach Möglichkeit geschwärzten privaten Kennungen.
- Relevante Datei und die letzte Aktion vor dem Fehler.
Das Problem als Umgebungs-, Konfigurations-, Code-, Ressourcen-, Laufzeit-, Layout/Input-, Cloud- oder Berechtigungsproblem klassifizieren. Eine testbare Hypothese bilden, die kleinste sichere Änderung vornehmen und den fehlgeschlagenen Verifikationsschritt wiederholen.
Referenzkarte
- Anfängervoraussetzungen und benutzereigene Aktionen: references/beginner-onboarding.md
- Natives Mini-Programm-Route: references/mini-program.md
- Natives Mini-Spiel-Route: references/mini-game.md
- Optionale CloudBase-Route: references/cloudbase.md
- Vorschau-Akzeptanz und Qualitätstore: references/preview-gates.md
- Fehler- und Screenshot-Diagnose: references/troubleshooting.md
- Zugangsdaten, Datenschutz und Asset-Provenienz: references/security.md
- Versionssensible offizielle Quellen: references/official-links.md