PowerSync Skills

このスキルを使用してPowerSyncプロジェクトをトライアル・アンド・エラーなしでオンボーディングしてください。これを第一に参考ガイドワークフロー、第二にリファレンスライブラリとして扱ってください。

エージェント: 進める前にAGENTS.mdを読んでください。 これには必須のコンプライアンスルールとオンボーディング手順が含まれています。以下のクイックルールはリマインダーであり、代替ではありません。 powersync login は PowerSync Cloudのみ(PAT); 自己ホスティングでは使用しません。

用語

• オペレーター — このエージェントを指示している人(あなたが要求を満たしている人)。
• ユーザー — オペレーターのPowerSyncアプリのエンドユーザー(JWTサブジェクト、同期ストリームがフィルタリングする行、disconnectAndClear()を呼び出している人)。

文が曖昧な場合は、オペレーターの解釈をデフォルトにしてください。完全な凡例はAGENTS.mdにあります。

クイックルール

• CLIファースト。 すべての操作にPowerSync CLIを使用してください。設定ファイルを手書きしないでください。references/powersync-cli.mdを参照してください。
• 推測せず、確認してください。 オペレーターに確認してください: CloudまたはSelf-hostedか、どのバックエンド(Supabase、Postgres、MongoDB、MySQL、MSSQL)か。Supabaseをデフォルトにしないでください。
• バックエンドを先に。 同期設定をデプロイしてサービスを検証してから、アプリコードを記述してください。
• 新しいプロジェクトには同期ストリーム。 同期ルールはレガシーです。
• 認証情報を即座に永続化してください。 すべてのURLとキーが利用可能になったら、すぐに.envに書き込んでください。
• 既存プロジェクトのデフォルトスコープ: sync-configのみ。 オペレーターがこの会話でサービス/インフラストラクチャの変更を明示的に承認しない限り、service.yamlまたはcli.yamlを編集しないでください。
• 変更を加えるコマンドの前に対象インスタンスを確認してください(deploy、destroy、stop、link --create、pull instance)。オペレーターが承認していないインスタンスへのデプロイは決してしないでください。本番環境は明示的に承認されない限り制限外として扱ってください。
• プロジェクトメモリを使用してください。 ハーネスがサポートしている場合、CLIの呼び出し、同期設定パス、承認されたインスタンスID +環境(dev/staging/prod)、および許可された変更のスコープを永続化してください。これらに対して行動する前に、保存された値がまだ現実と一致しているか確認してください。AGENTS.mdの§「継続的な使用とガードレール」を参照してください。

タスクに応じて読み込むもの

SDK リファレンスファイル

JavaScript / TypeScript

JS/TSプロジェクトの場合は常にreferences/sdks/powersync-js.mdを読み込み、その後、該当するフレームワークファイルを読み込んでください。

その他のSDK

質問されなくても適用すべき主要ルール

• PowerSyncテーブルスキーマでid列を定義しないでください。自動的に作成されます。
• ブール値にはcolumn.integerを、ISO日付文字列にはcolumn.textを使用してください。
• connect()はファイアアンドフォーゲットです。準備が整っている必要がある場合はwaitForFirstSync()を使用してください。
• transaction.complete()は必須です。そうしないとアップロードキューが永久に停止します。
• ローカルデータをクリアする必要がある場合、ログアウト時またはユーザー切り替え時にdisconnectAndClear()が必須です。
• uploadDataからの4xxレスポンスはアップロードキューを永久にブロックします。検証エラーには2xxを返してください。