PowerSync

Intégration PowerSync guidée : configuration CLI-first, config de synchronisation et règles SDK footgun

par powersync-ja · powersync-ja/agent-skills

Testé · Fonctionne ★ 9.2/10

PowerSync — Intégration PowerSync guidée : configuration CLI-first, config de synchronisation et règles SDK footgun

Ce que fait

Flux de travail d'intégration maintenu par le fournisseur pour la synchronisation offline-first de PowerSync, couvrant la configuration Cloud et auto-hébergée, la configuration des flux de synchronisation, l'intégration backend pour Supabase, Postgres, MongoDB, MySQL et MSSQL, et onze guides SDK client. Se déclenche chaque fois que l'utilisateur mentionne PowerSync, la synchronisation offline-first ou local-first, les règles de synchronisation, uploadData ou fetchCredentials, ou souhaite des données hors ligne dans une application mobile ou web. Applique la préparation du backend avant le code de l'application et contient les règles SDK qui rompent silencieusement la synchronisation lorsqu'elles sont manquées.

Rapport de test

La règle stricte de la compétence 'never define the id column' n'est pas un conseil de style : un schéma de tâches en mémoire qui déclare id génère 'An id column is automatically added, custom id columns are not supported' de Schema.validate() dans le package @powersync/common réel, tandis que le schéma écrit sous la compétence est validé proprement. La règle transaction.complete() qu'elle propose est la même chose que le bundle livré par PowerSync avertit lorsque la file d'attente de téléchargement est bloquée. Son SKILL.md de 84 lignes est un routeur plutôt qu'un mur de texte, pointant vers 14 fichiers de référence et onze guides SDK, et le validateur du dépôt confirme que les 81 liens internes sont résolus. La partie Cloud (login, link, deploy) nécessite un compte PowerSync et n'a pas été exercée, donc le delta mesuré ne concerne que la tranche du schéma client.

Testé le: 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

Commandes et exemples de prompts

  • /powersyncIntégration PowerSync guidée : configuration CLI-first, config de synchronisation et règles SDK footgun

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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