用途:为 Solid.js 项目提供成体系的开发规范,供 AI 辅助生成代码、代码审查、重构以及排查响应式问题时参考。
主要能力:按类别给出规则与优先级。响应式方面强调信号必须作为函数调用(count())、派生值用 createMemo、createEffect 只做副作用、避免在 effect 中写信号、必要时用 untrack 与 batch。组件方面禁止解构 props、禁止提前 return、禁止把组件当普通函数调用,推荐 mergeProps、splitProps、children 辅助,并使用 class/for 而非 className/htmlFor。控制流推荐 Show、For、Index、Switch/Match 并注意 keyed 与 fallback。状态管理区分 signal 与 store,推荐路径语法、produce、reconcile、Context,并注意函数值包装与页面级清理。Refs/DOM 强调回调 ref、在 onMount 访问 DOM、onCleanup 清理、避免 innerHTML。性能涉及避免多余追踪、lazy、Suspense、classList。无障碍要求语义化 HTML、ARIA、键盘导航。测试部分给出 Vitest 配置、render(() => <C />) 写法、createRoot/renderHook、异步查询、浏览器模式、IndexedDB/localStorage 清理、MemoryRouter 与 QueryClient 配置等。Web Component 集成强调在应用入口注册自定义元素、slotchange 副作用延迟、单向数据流、prop:*/on: 绑定与按需导入。
使用方式:按任务类型选取规则,例如写新组件、集成 Web Component、代码审查、性能优化、状态管理、无障碍审计、编写测试。资料未提供安装命令或具体调用方式。
适用场景:任何 SolidJS 项目的开发与维护,尤其是响应式调试、组件重构、测试搭建和自定义元素集成。
限制:资料以规则清单和示例为主,未说明收费、平台支持范围或效果保证;具体 API 行为需以官方文档为准。