Svelte
Svelte/SvelteKit 开发助手：调试、构建与迁移
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Svelte。 它的用途是：Svelte/SvelteKit 开发助手：调试、构建与迁移 完整的 Skill 内容见：https://321skill.com/skills/svelte-x-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的 SvelteKit 项目在部署到 Cloudflare 时构建失败，报错 Cannot find module '@sveltejs/adapter-cloudflare'，请帮我修复。' AI 会检查 adapter 安装情况，提示安装依赖并配置 svelte.config.js。另一个例子：'帮我将这段 Svelte 4 组件迁移到 Svelte 5 的 runes 语法，包含 export let 和 $: 语句。' AI 会逐行转换并解释变更。
介绍
本 Skill 专为 Svelte 和 SvelteKit 开发者设计，解决从状态更新失效到构建失败的各类棘手问题。当 UI 不响应状态变化、effect 陷入无限循环（effect_update_depth_exceeded）、props 或 bindings 失去响应、Map 或 class 字段不被追踪、服务端状态泄漏、window is not defined 导致构建中断、水合标记不匹配、数据在 mutation 后仍陈旧、form action 无反应或返回 403、作用域 CSS 被误删、过渡动画不触发，以及 Node/Vercel/Cloudflare/静态适配器构建失败时，均可使用本 Skill 快速定位并修复。
使用方法：将你的 Svelte 或 SvelteKit 项目代码片段、错误信息或编译日志提供给 AI，它会分析问题根因并给出具体修复方案。支持从 Svelte 4 迁移到 Svelte 5 的新语法（runes、$props、$derived、callback props、snippets、onclick 等），以及 TypeScript 类型化、Vitest/Playwright 测试、包体积和重渲染优化。你只需描述问题或粘贴代码，AI 即可进行调试、重构或代码审查。
适合人群：Svelte 前端开发者、全栈开发者、SvelteKit 项目维护者、正在从 Svelte 4 升级到 Svelte 5 的团队、需要快速排查 Svelte 特有运行时和构建错误的开发者。对于熟悉 React/Vue 但刚接触 Svelte 的开发者，本 Skill 也能帮助理解其语法差异和最佳实践。
建议：使用前请确保提供完整的相关代码上下文（如组件文件、路由文件、svelte.config.js）。对于迁移任务，建议分阶段提交代码，以便 AI 逐步处理。本 Skill 不适用于 Vue、Nuxt、React 或纯浏览器 JavaScript 场景，请勿在非 Svelte 项目上使用。
核心特点
相比通用前端调试工具，本 Skill 深度理解 Svelte 5 的 runes 响应式系统、SvelteKit 的 load/form action/adapter 机制，并能自动识别 Svelte 4 到 Svelte 5 的迁移模式，提供一对一的语法转换和错误修复。
注意事项
不适用于 Vue、Nuxt、React 或纯浏览器 JavaScript 场景，且无法处理非 Svelte 项目的构建问题。
常见问题
effect_update_depth_exceeded 怎么解决？
通常是因为effect中依赖了自身更新的状态，请检查effect内是否有对响应式变量的写操作，改用$effect或使用untrack隔离无关依赖。
window is not defined 在 SvelteKit 中如何避免？
在组件中使用browser模块或onMount判断客户端环境，避免在模块顶层直接访问window。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/svelte-x-8/raw/index.md 读取 Svelte 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/svelte-x-8/raw/index.md（查看排版版本）