Svelte最佳实践

📌 Skill基础信息

Skill名称：svelte-best-practices

简称：Svelte 5 最佳实践

来源：社区第三方（开发者 aleconstancio）

运行宿主：只能在使用 Bindrunes Agent 工具的环境中运行

核心定位：为 Svelte 5 项目提供现代化的开发规范和最佳实践指导，特别适合代码编写和代码审查场景。

🧩 内部核心组成

该 Skill 主要包含 Svelte 5 开发规范的完整知识体系，无子Agent、斜杠命令或MCP工具。核心组成包括：

规范体系：

• Runes 使用规范（替代传统响应式语法）
• 组件架构模式
• 可组合模式（createX() 模式）
• 上下文管理模式
• 响应式规则体系
• SvelteKit 路由约定
• 测试最佳实践

技术约束：

• 强制使用 Svelte 5 新特性
• 禁止使用传统模式（export let、$: 等）
• 文件命名和扩展名规范

🛠 安装与启用方式

安装命令：

skills install --user aleconstancio/bindrunes

前置要求：

• 已安装 Bindrunes Agent 环境
• 项目基于 Svelte 5 或计划升级到 Svelte 5
• 使用 TypeScript 开发

启用方式：安装后该 Skill 将作为代码辅助工具在 Bindrunes Agent 中自动启用，提供实时建议和规范检查。

📋 标准工作流

1. 开发阶段：开发者在编写 Svelte 组件时，Skill 实时提供代码建议
2. 代码审查：在审查代码时自动识别不符合 Svelte 5 最佳实践的代码模式
3. 规范指导：

- 提示使用 $state、$derived 等 runes 替代传统语法

- 推荐使用 createX() 模式封装状态逻辑

- 检查组件架构是否符合单一职责原则

- 验证 SvelteKit 路由配置规范性

1. 错误预防：提前识别可能导致响应式问题的代码模式

⚠️ 关键限制、缺陷、注意事项

平台限制：

• 仅支持 Svelte 5 及以上版本
• 不兼容 Svelte 3/4 传统项目
• 依赖 Bindrunes Agent 运行环境

适用项目：

• 新启动的 Svelte 5 项目
• 计划全面升级到 Svelte 5 的现有项目
• 注重代码质量和可维护性的项目

不适用场景：

• 维护中的 Svelte 3/4 老项目（会产生大量冲突建议）
• 不使用 TypeScript 的 Svelte 项目
• 小型或快速原型项目（规范可能过于严格）

生产环境：可用于生产环境，但需要团队全员接受 Svelte 5 新范式

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

• Svelte 5 新项目开发团队
• 需要统一代码规范的跨团队协作项目
• 代码质量要求较高的企业级应用
• 需要自动化代码审查的 DevOps 流程
• 学习 Svelte 5 新特性的开发者

❌ 不适合场景：

• 维护现有 Svelte 3/4 代码库
• 快速原型验证或概念验证项目
• 团队尚未接受 Svelte 5 新语法的工作流程
• 不使用 TypeScript 的 JavaScript 项目

skills install --user aleconstancio/bindrunes