用途
Lovable 集成技能用于让 Claude Code 在 Lovable.dev 项目中有效工作，同时遵守 Lovable 的部署要求。当用户提到「Lovable」或「lovable.dev」、项目存在 supabase/ 目录与 Edge Functions、用户要求部署边缘函数、创建数据库迁移、询问 Lovable Cloud 或后端部署，或项目呈现 Lovable 项目特征（React + Supabase 结构）时激活。
初始化或重新初始化请使用 ../init/SKILL.md。在提交任何 Lovable 提示词之前，需应用提示词授权规则：YOLO 开启时授予常驻授权；YOLO 关闭时适用通用确认规则。与 Lovable 交互前还需应用额度效率原则：尽可能在本地完成工作，使用浏览器 Cloud 页面而非 MCP/聊天来检查后端状态，并将不可或缺的托管操作合并为一个最小提示词。
项目架构类型
Lovable 支持两种架构，给出建议前必须先检测当前项目属于哪一种。检测方法：查看项目根目录，存在 app.config.ts 则为 TanStack Start（新架构，SSR，2026 年 4 月后创建）；存在 vite.config.ts 则为 Vite SPA（旧架构，CSR，2026 年 4 月前创建）。两者均受完整支持，旧项目保留在 Vite 上，不会被强制迁移。
Vite SPA 架构（旧）
2026 年 4 月前创建的项目，仅客户端渲染。
可自由编辑并推送到 main 的内容：src/（所有 React 组件、页面、hooks、工具）、public/（静态资源）、配置文件（vite.config.ts、tailwind.config.js、tsconfig.json）、package.json（依赖）、supabase/functions//index.ts（边缘函数代码，非部署）、supabase/migrations/.sql（迁移文件，非应用）。
编辑后需要 Lovable 部署的操作：边缘函数代码需提示「Deploy the [name] edge function」；全部边缘函数需提示「Deploy all edge functions」；新迁移文件需提示「Apply pending Supabase migrations」；需要新表需提示「Create a [name] table with columns: [list]」；RLS 策略需提示「Enable RLS on [table] allowing [who] to [what]」；存储桶需提示「Create a [public/private] bucket called [name]」；密钥/环境变量需手动在 Cloud → Secrets → Add 添加。
TanStack Start 架构（新项目）
2026 年 4 月后创建的项目，通过 TanStack Start 实现完整服务端渲染（SSR）。与 Vite SPA 的关键差异：路由为 app/routes/ 下的基于文件路由（而非 src/App.tsx 中的 React Router）；配置文件为 app.config.ts（而非 vite.config.ts）；服务端函数（createServerFn）让服务端逻辑直接存在于组件文件中，简单服务端逻辑无需边缘函数；命名为 *.server.ts 的文件仅服务端使用，永不发送到浏览器；页面在到达浏览器前已在服务端渲染为完整 HTML。
可自由编辑并推送到 main 的内容：app/（所有路由、组件、服务端函数、布局）、app/routes/（基于文件的路由页面）、public/（静态资源）、app.config.ts、tailwind.config.js、tsconfig.json（配置文件）、package.json（依赖）、app/**/.server.ts（TanStack 服务端函数，自动部署，无需 Lovable 提示词）、supabase/functions//index.ts（Supabase 边缘函数代码，非部署）、supabase/migrations/*.sql（迁移文件，非应用）。
编辑后需要 Lovable 部署的操作：Supabase 边缘函数代码需提示「Deploy the [name] edge function」；全部 Supabase 边缘函数需提示「Deploy all edge functions」；新迁移文件需提示「Apply pending Supabase migrations」；需要新表需提示「Create a [name] table with columns: [list]」；RLS 策略需提示「Enable RLS on [table] allowing [who] to [what]」；存储桶需提示「Create a [public/private] bucket called [name]」；密钥/环境变量需手动在 Cloud → Secrets → Add 添加。
注意：TanStack 服务端函数（createServerFn）不是 Supabase 边缘函数，它们位于 app/ 中并通过 GitHub 同步自动部署，无需 Lovable 提示词；只有 supabase/functions/ 需要手动部署。
核心概念（两种架构通用）
Lovable 仅在 main 分支上使用双向 GitHub 同步：前端与服务端代码（包括 TanStack 服务端函数）自动同步；Supabase 边缘函数与数据库迁移在代码变更后需要 Lovable 提示词。
响应格式
需要后端部署时，始终输出：
📋 LOVABLE PROMPT:
"[可直接复制粘贴的精确提示词]"
对于破坏性操作，附加：
⚠️ Warning: [风险说明]
文件结构参考
Vite SPA（旧，存在 vite.config.ts）：project/ 下含 src/（components、pages、hooks、lib、integrations/supabase/，其中 client.ts 含 Supabase URL，types.ts）、supabase/（functions/[function-name]/index.ts、migrations/YYYYMMDDHHMMSS_*.sql、config.toml 由 Lovable Cloud 管理）、.env（仅本地，Lovable 忽略）、CLAUDE.md（项目上下文）。
TanStack Start（新，存在 app.config.ts）：project/ 下含 app/（routes/ 含 _root.tsx、index.tsx、[name].tsx，components/、lib/、integrations/supabase/、*.server.ts）、app.config.ts、public/、supabase/（functions/[function-name]/index.ts、migrations/YYYYMMDDHHMMSS*.sql、config.toml 由 Lovable Cloud 管理）、.env（仅本地，Lovable 忽略）、CLAUDE.md（项目上下文）。
后端类型
Lovable Cloud：后端完全由 Lovable 管理，无 Supabase 仪表盘访问权限，所有操作通过 Lovable 提示词完成，密钥在 Cloud → Secrets UI 中设置。
自有 Supabase：可直接访问 Supabase 仪表盘，可使用 Supabase CLI（supabase functions deploy），更灵活但需手动设置。
常用提示词参考
边缘函数：「Deploy all edge functions」「Deploy the send-email edge function」「Create an edge function called [name] that [description]」「Show logs for [name] edge function」「The [name] edge function returns [error]. Fix it」。
数据库：「Create a [name] table with columns: id (uuid), name (text), created_at (timestamp)」「Add a [column] column of type [type] to [table]」「Add foreign key from [table1].[col] to [table2].id」「Apply pending Supabase migrations」。
RLS 策略：「Enable RLS on [table]」「Add RLS policy on [table] allowing authenticated users to read all rows」「Add RLS policy on [table] allowing users to only access their own rows」。
存储：「Create a public storage bucket called [name]」「Create a private storage bucket called [name]」「Allow authenticated users to upload to [bucket]」。
认证：「Enable Google authentication」「Enable GitHub authentication」「When user signs up, create row in profiles table」。
分支规则
仅 main 与 Lovable 同步；功能分支在合并前不会部署；Lovable 在推送后 1-2 分钟内同步。
YOLO 模式——自动化部署（Beta）
当 CLAUDE.md 中 yolo_mode: on 时，部署通过浏览器自动化完成。工作方式：不再显示手动提示词，由 yolo 技能（/skills/yolo/SKILL.md）接管——自动导航到 Lovable.dev、提交部署提示词、监控成功/失败、运行验证测试（若启用）、报告部署摘要。激活时机：执行 /lovable:deploy-edge 命令期间、执行 /lovable:apply-migration 命令期间、CLAUDE.md 中 yolo_mode: on 时。配置命令：/lovable:yolo on（启用并测试）、/lovable:yolo on --no-testing（启用不测试）、/lovable:yolo on --debug（启用并输出详细日志）、/lovable:yolo off（禁用）。Beta 状态：需要 Claude in Chrome 扩展，可能存在 bug 或 UI 兼容性问题，始终保留手动回退方案，详见 /skills/yolo/SKILL.md。
调试清单
前端未更新：是否在 main 分支？更改是否已推送？等待 1-2 分钟。
边缘函数不工作：是否通过 Lovable（或 yolo 模式）部署？密钥是否在 Cloud UI 中设置？在 Lovable 中检查日志。
数据库查询失败：迁移是否已应用（通过 Lovable 或 yolo 模式）？RLS 策略是否正确？表是否存在？
YOLO 模式不工作：检查 CLAUDE.md 中 yolo_mode: on？Chrome 扩展是否安装？是否已登录 Lovable？详见 yolo 技能排障。