Aitishiku.comSkill名称：svelte5-runes-static
简称：Svelte 5 静态适配器模式
来源：社区第三方（bobmatnyc）
运行宿主：Claude MPM（Model Package Manager）
核心定位：为 Svelte 5 + SvelteKit adapter-static 提供预渲染安全的响应式状态管理方案，解决 hydration 不匹配和状态冻结问题。
🧩 内部核心组成
能力模块
- 状态管理专家：提供全局 store 与组件 runes 状态的桥接模式
- SSG/SSR 适配器：针对 adapter-static 的预渲染兼容方案
- 类型安全架构：完整的 TypeScript 类型支持
- 性能优化指南：避免过度响应式和计算缓存策略
核心约束规则
| 约束类型 | 问题描述 | 解决方案 |
|---|---|---|
| 模块级 Runes | 预渲染后状态冻结 | 改用传统 writable() stores |
| $ 自动订阅 | Runes 模式不支持 | 手动订阅 + $effect 桥接 |
| Getter 模式 | 响应式连接中断 | 直接导出 store 引用 |
🛠 安装与启用方式
安装命令：
skills install --user bobmatnyc/claude-mpm-skills前置依赖：
- Svelte 5.0+ 项目
- SvelteKit adapter-static
- TypeScript（推荐）
启用方式：通过 Claude MPM 工具链自动集成，无需手动配置入口命令。
📋 标准工作流
- 用户发起请求：咨询 Svelte 5 静态站点状态管理问题
- Skill 自动触发：识别 adapter-static 和 runes 关键字
- 模式诊断：分析当前代码中的反模式（模块级 runes、错误订阅等）
- 方案推荐：
- 全局状态 → 传统 stores (writable/derived)
- 组件状态 → Svelte 5 runes ($state/$derived)
- 桥接模式 → $effect 订阅 + 状态同步
- 代码生成：提供类型安全的混合模式实现模板
- 验证指导：输出迁移清单和测试模式
⚠️ 关键限制、缺陷、注意事项
平台限制：
- ❌ 仅适用于 SvelteKit adapter-static（SSG/静态站点）
- ❌ 不兼容 adapter-node/adapter-vercel 等 SSR 适配器
性能考虑：
- ⚡ 桥接模式增加少量运行时开销
- ⚡ 需避免过度响应式导致的重复计算
生产环境适用性：
- ✅ 可用于生产环境，但需严格遵循模式约束
- ✅ 经过预渲染和 hydration 验证
已知坑点：
- 模块级 runes 在预渲染后完全失效
- $ 自动订阅语法在 runes 模式不可用
- Getter 模式会破坏响应式连接
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景
- 静态生成站点：使用 SvelteKit adapter-static 的文档站、博客、营销页
- 混合状态管理：需要全局 store 与组件局部状态协同的项目
- TypeScript 项目：需要完整类型安全的 Svelte 5 应用
- 迁移项目：从 Svelte 4 升级到 Svelte 5 的静态站点
❌ 不适合场景
- 纯 SSR 应用：使用 adapter-node 等服务器端渲染适配器
- 纯客户端 SPA：未使用 SvelteKit 或 adapter-static
- 简单组件：无需全局状态管理的小型组件库
- 非 TypeScript 项目：JavaScript 项目可使用但无法发挥全部优势
如何安装
skills install --user bobmatnyc/claude-mpm-skills通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
本 Skill 涉及读取隐私 / 敏感信息（如密钥、环境变量、凭据）。安装前请确认其用途是否必要。
检测到隐私/敏感信息读取（预设模式 #9）
命中检测项
- privacy_collect