用途
该技能用于在使用 SvelteKit 2 + Svelte 5 + Tailwind CSS v4 技术栈开发网站时，提供集成的配置、编码与排错指导。它面向需要把这三种工具组合起来使用的开发场景，重点解决单独查阅各工具文档难以覆盖的集成问题。
覆盖的技术栈
SvelteKit 2 是现代化全栈框架，特性包括基于文件的路由与布局、服务端渲染（SSR）与静态站点生成（SSG）、带渐进增强的表单 actions，以及多种部署适配器（Vercel、Cloudflare、Node、静态）。 Svelte 5 引入新的响应式系统，包括 runes：$state()、$derived()、$effect()、$props()，并简化组件编写、改善 TypeScript 支持，以 snippets 取代 slots。 Tailwind CSS v4 提供 CSS 优先配置、新的 Vite 插件架构、改进的 JIT 性能与简化安装。
针对的集成挑战
技能明确列出所解决的问题：三套工具的协同配置；在 SSR 上下文中理解 Svelte 5 runes；表单 actions 的渐进增强；开发与生产环境的 CSS 加载；跨平台部署；从早期版本迁移。文中特别强调「runes 在 SSR 中不工作」等约束，要求在实现前先检索文档。
文档集合
技能内置两套可检索文档集合，需通过搜索访问。 references/：17 篇问题导向指南，包含 getting-started.md、project-setup.md、svelte5-runes.md、routing-patterns.md、server-rendering.md、data-loading.md、forms-and-actions.md、styling-with-tailwind.md、styling-patterns.md、deployment-guide.md、migration-svelte4-to-5.md、tailwind-v4-migration.md、best-practices.md、performance-optimization.md、common-issues.md、troubleshooting.md 与 documentation-search-system.md。 docs/：7 篇完整参考，包含 sveltekit-configuration.md、svelte5-api-reference.md、tailwind-configuration.md、adapters-reference.md、advanced-routing.md、advanced-ssr.md、integration-patterns.md。
使用方式：五阶段检索流程
技能要求先检索再实现。Stage 0：用 find . -name "index.jsonl" -type f 发现所有文档索引（预期为 ./references/index.jsonl 与 ./docs/index.jsonl），并各抽样 5 条了解范围。Stage 1：完整读取所选集合的 index.jsonl。Stage 2：根据摘要推理出 3 至 4 个最相关文件，并给出按问题类型对应的候选示例（如设置问题查 getting-started.md 与 project-setup.md，runes 问题查 svelte5-runes.md 与 svelte5-api-reference.md 等）。Stage 3：读取候选文件的 sections.jsonl 条目，索引号对应行号。Stage 4：按 sections.jsonl 中的 offset 与 limit 精确读取相关段落。Stage 5：综合多来源信息输出答案、可运行代码示例、集成注意事项与文件引用（例如 Seen: references/svelte5-runes.md:156-245）。
快速开始（文中示例）
创建项目：npm create svelte@latest my-app、cd my-app、npm install。安装 Tailwind v4：npm install -D tailwindcss@next @tailwindcss/vite@next。配置 vite.config.js 时引入 @sveltejs/kit/vite 与 @tailwindcss/vite，注意 tailwindcss() 必须放在 sveltekit() 之前。新建 app.css 写入 @import "tailwindcss"。在根布局 src/routes/+layout.svelte 中 import '../app.css'。最后 npm run dev 验证。
集成模式示例
文中给出三类模式：服务端与客户端组件拆分（SSR 安全的 +page.svelte 与仅在客户端使用 runes 的 ClientCounter.svelte）；使用 use:enhance 手动回调实现表单渐进增强；条件式 Tailwind 类名应使用完整类名（class:bg-blue-500={active}）而非动态拼接类名片段。
适用场景与常见问题
技能覆盖配置安装、SSR 下的 runes、表单与渐进增强、组件样式、数据加载、部署（Vercel、Cloudflare、Node、静态）、错误排错等场景。常见问题与快速修复包括：生产环境 CSS 不加载（检查 Vite 插件顺序与 CSS 导入位置）、runes 引发 SSR 错误（不要在 SSR 组件中使用 $state() 或 $effect()）、提交表单丢失状态（使用手动 enhance() 回调）、HMR 失效（检查插件顺序与文件监听设置）、Tailwind 类名失效（检查内容路径与使用完整类名）。
版本与发行方式
技能覆盖 SvelteKit 2.x（最新稳定版）、Svelte 5.x（含 runes）、Tailwind CSS 4.x（CSS 优先配置），文中称所有示例均以这些版本测试。发行方式为作者专有发行（author-only distribution）：内容全部为原创撰写，不含供应商文档逐字内容，源材料仅作参考，所有指南在 frontmatter 中标注来源（adapted_from）。
限制
资料未提供价格、收费模式、授权条款细节、支持平台清单之外的信息，也未提供实测性能数据或效果承诺；检索所需的具体命令与文件路径依赖技能包本地目录结构。