Communitygithub.com

SEKAI-SEEK/wechat-starter

Ein anfängerfreundlicher Agent-Skill zum Erstellen nativer WeChat-Mini-Programme und -Minispiele von der ersten Idee bis zur DevTools-Vorschau.

Was ist wechat-starter?

Dieser Skill begleitet einen Entwickler vom ersten Gedanken bis zur funktionierenden Vorschau in den WeChat DevTools. Er ist bewusst für Anfänger konzipiert und arbeitet standardmäßig im Anfänger-Modus, wechselt aber auf Anfrage in den Entwickler-Modus. Der Skill führt durch sieben klar definierte Phasen: von der Umgebungsvorbereitung (Stage 0) über die Ideenfindung (Stage 1), das Gerüstbauen und Kompilieren (Stage 2), den Bau einer ersten durchgehenden Kernfunktion (Stage 3), die Erweiterung um akzeptierte Funktionen (Stage 4), die Härtung der Vorschau (Stage 5) bis zur finalen Abnahme (Stage 6). Zu den Kernprinzipien gehören: schrittweises Lehren und Handeln, maximal drei Fragen pro Runde, keine langen Tutorial-Dumps, Einhaltung strenger Sicherheitsregeln (keine Geheimnisse in Quellcode oder Chat), Diagnose von Fehlern anhand von Screenshots und Konsolenausgaben sowie die ausschließliche Erstellung lokaler Git-Checkpoints. Der Skill unterstützt native WeChat Mini-Programme (WXML/WXSS/JS) und Mini-Spiele (Canvas 2D/JS). Frameworks oder CloudBase werden nur auf expliziten Wunsch des Benutzers aktiviert.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add SEKAI-SEEK/wechat-starter

In Ihrer bevorzugten KI fragen

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

Dokumentation

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:

  1. Lehren: Das unmittelbare Ziel erklären und jeden neuen Begriff in einem einfachen Satz definieren.
  2. Tun: Code- und Dateisystemarbeiten ausführen, die sicher abgeschlossen werden können; eine kleine Aktionsgruppe für benutzereigene DevTools- oder Kontoschritte bereitstellen.
  3. Verifizieren: Das genaue sichtbare Ergebnis, die Befehlsausgabe oder das Verhalten angeben, das den Erfolg beweist.
  4. Wiederherstellen: Wenn die Verifikation fehlschlägt, eine evidenzgestützte Ursache nach der anderen diagnostizieren und erneut versuchen.
  5. 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:

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:

  1. DevTools kompiliert fehlerfrei.
  2. Der primäre Ablauf ist von Anfang bis Ende bedienbar.
  3. Erforderliche Konfigurations-, Ressourcen- und Paketprüfungen bestanden.
  4. Ein Screenshot oder eine präzise Beobachtung zeichnet das Vorschauergebnis auf.
  5. 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

Verwandte Skills