PowerSync

Geführtes PowerSync-Onboarding: CLI-first Setup, Sync-Konfiguration und SDK-Fallstricke

von powersync-ja · powersync-ja/agent-skills

Getestet · Funktioniert ★ 9.2/10

PowerSync — Geführtes PowerSync-Onboarding: CLI-first Setup, Sync-Konfiguration und SDK-Fallstricke

Was es kann

Vom Anbieter gepflegter Onboarding-Workflow für PowerSync Offline-First-Synchronisierung, der Cloud- und selbstgehostete Einrichtung, Sync-Stream-Konfiguration, Backend-Integration für Supabase, Postgres, MongoDB, MySQL und MSSQL sowie elf Client-SDK-Anleitungen umfasst. Wird ausgelöst, wenn der Benutzer PowerSync, Offline-First- oder Local-First-Synchronisierung, Synchronisierungsregeln, uploadData oder fetchCredentials erwähnt oder Offline-fähige Daten in einer mobilen oder Web-App wünscht. Erzwingt die Backend-Bereitschaft vor dem App-Code und enthält die SDK-Regeln, die die Synchronisierung bei Nichtbeachtung stillschweigend unterbrechen.

Testbericht

Die pauschale Regel des Skills 'never define the id column' ist kein Stilhinweis: Ein aus dem Gedächtnis erstelltes todos-Schema, das id deklariert, wirft 'An id column is automatically added, custom id columns are not supported' aus Schema.validate() im echten @powersync/common-Paket, während das unter dem Skill geschriebene Schema sauber validiert. Die transaction.complete()-Regel, mit der es beginnt, ist dasselbe, wovor PowerSyncs eigenes ausgeliefertes Bundle warnt, wenn die Upload-Warteschlange stockt. Sein 84-zeiliges SKILL.md ist eher ein Router als eine Textwand, der auf 14 Referenzdateien und elf SDK-Anleitungen verweist, und der Validator des Repos bestätigt, dass alle 81 internen Links aufgelöst werden. Die Cloud-Hälfte (Login, Link, Deploy) benötigt ein PowerSync-Konto und wurde nicht getestet, sodass die gemessene Delta nur auf dem Client-Schema-Slice liegt.

Getestet am: 2026-08-05 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/powersync-ja/agent-skills.git
mkdir -p ~/.claude/skills
cd agent-skills && cp -r skills/powersync ~/.claude/skills/powersync

Befehle & Beispiel-Prompts

  • /powersyncGeführtes PowerSync-Onboarding: CLI-first Setup, Sync-Konfiguration und SDK-Fallstricke

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Add offline-first sync to my Expo app using PowerSync
  • Write PowerSync sync rules for my Postgres tables please
  • My app is stuck on Syncing forever, help debug PowerSync