菜单
Use when working in src/lib/sync/**, on offline/local-first behavior, multi-device merge, conflict resolution, localStorage state, or upload/import — covers the merge laws (monotonic max, per-cell LWW, append-only ledgers, tombstones), seed-fiction provenance, and the derived-cache rule.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use before claiming any BetterMe task is done, or when verifying a change — the exact 4-gate sequence (typecheck, lint, vitest, build), Windows/PowerShell/pnpm specifics, single-test and dev-bypass usage, and what counts as evidence.
Use when writing or editing any user-facing Vietnamese copy — pet/companion voice lines, toasts, greetings, milestone text, or friend/garden messaging. Covers the no-guilt and no-comparison invariants, host vs guest voice, per-species tone, and the test that enforces them.
Use when editing supabase/schema.sql, RLS policies, RPCs, or the server actions in src/lib/server/** — covers owner-only RLS, SECURITY DEFINER cross-user reads, RPC-only writes, idempotent schema patterns, the append-only food ledger, and the never-throw server-action contract.
Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.
Comprehensive design guide for web, mobile, and desktop applications. Contains 67 styles, 161 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 22 technology stacks.
| name | sync-engine |
| description | Use when working in src/lib/sync/**, on offline/local-first behavior, multi-device merge, conflict resolution, localStorage state, or upload/import — covers the merge laws (monotonic max, per-cell LWW, append-only ledgers, tombstones), seed-fiction provenance, and the derived-cache rule. |
localStorage is the render source of truth; Supabase is the durable copy and multi-device
merge point. The pure-function layer in dashboard-data.ts keeps its shape — sync metadata
lives outside DashboardState. Files: src/lib/sync/{types,time,storage,queue,shadow,merge,importer,engine}.ts (+ tests).
src/lib/sync/merge.ts)| Data | Rule | Why |
|---|---|---|
| Reward state (growth, bond) | monotonic max() | the no-decay invariant, as conflict resolution |
| Habit completion cells | per-cell LWW (shadow map betterme.syncmeta.v1 + habit_logs.mutated_at) | an untick must propagate, not be lost |
| Food economy | append-only ledger union; balance is derived, never merged | money-like; deduplicate by ledger key |
| Pet name / active species | per-field LWW | last edit wins per field |
| Habit deletion | tombstones | deletion must survive merge |
| Reset supremacy | by server-issued serverTime | reset beats stale reward writes |
date <= seedCutoverDate never leave the
device. bestStreakFloor and seeded events are fiction — never sync them.betterme.syncqueue.v1) carries SET-based idempotent mutations, coalesces,
backs off, and must not head-of-line-block.FOOD_CAP = 21); spend is never lost (union set).betterme.dashboard.v2 — state (v1 is read-only; migration auto-runs)betterme.syncqueue.v1 — pending mutations · betterme.syncmeta.v1 — shadow LWWbetterme.synclast.v1 — watermark · betterme.syncoptin.v1 — 'fresh' | 'memories'betterme.syncask.v1 — deferred prompt · betterme.mailboxseen.v1 — celebrated visit idsderiveFoodBalance again;
never merge/store the balance.window.matchMedia — guard before using it (pattern already in pet.tsx).docs/superpowers/specs/ §2.4 and add tests
in merge.test.ts first (TDD).