关于 solidjs-v2-reviewer
solidjs-v2-reviewer 是用于依据 SolidJS 2.0 预发布行为和类型定义审查代码的清单型技能。它帮助审查者检查指定改动,同时要求 v1 审查遵循 v1 契约,并以具体证据支持问题报告。
主要功能
- 01依据 SolidJS 2 行为检查改动
- 02审查响应式状态和 effect
- 03评估异步处理与 mutation
- 04检查 DOM、SSR 和传输语义
- 05要求报告问题时提供证据
适用场景
- 01审查面向 SolidJS 2.0 的 diff
- 02检查响应式状态用法是否符合 v2
- 03识别迁移中的行为变化
- 04报告具体的运行时或类型问题
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ khmm12/ solidjs-v2-skills --skill solidjs-v2-reviewer安装后在 Claude Code 中输入/solidjs-v2-reviewer确认已加载。
详细介绍
审查 SolidJS 2.0
参考目标:[email protected] 和 @solidjs/[email protected]。
确定审查范围
读取已安装的 solid-js 版本,并审查请求的差异/文件。
应用此检查清单审查主要版本 2。审查 v1 时遵循其 v1 合约。
已发布目标版本的类型定义优先于示例和预发布文档。
检查行为
| 领域 | v2 所需行为 |
|---|---|
| 组件设置 | 每次挂载时运行一次;响应式 props 在 JSX/compute 中仍通过 props.x 读取 |
| Props | JSX 通过 getter 传递值;访问器类型 API 遵循其声明类型 |
| 派生状态 | 只读状态使用 memo/投影;可写派生使用函数形式的 signal/store |
| 写入/操作 | 在处理程序、effect 的 apply/error 回调或 onSettled 中调用;计算作用域用于派生 |
| 写入后读取 | 在微任务中提交;命令式即时读取遵循 flush() |
| Effects | 跟踪 compute + 非跟踪 apply;在 compute 中提取字段/深层快照,在 apply 中返回清理函数 |
| 绘制 | 两个通道都在绘制前运行;render 通道在用户 effects 之前测量/更新布局 |
| 初始异步 | 异步 memo/store 消费者置于 Loading 下;错误通过错误访问器传递到 Errored |
| 等待 UI | 输入变化或 action 作用域内的 affects 会触发等待状态;单独刷新不会触发;保存时使用乐观标志 |
| 变更排序 | 生成器 action 通过 yield 交出工作;内部 await 之后,在写入前 yield;yield 刷新以获取最新数据 |
| 实时确认 | until 谓词读取权威数据源,并使用关联标识和超时 |
| 清理 | 在 await/yield 前注册 compute 清理;取消操作会释放暂停的流 |
| 生命周期 | 在设置阶段创建原语;受所有权管理的 onSettled 返回拆卸函数,所有权外的回调只执行一次 |
| Stores | 使用草稿 setter;返回值会浅层替换;reconcile 的第二个参数是键/提取器/null |
| Store 身份 | 独立 reconcile 会保留所选根节点;派生返回值可替换权威根节点 |
| 浅层 Stores | 按引用替换根槽位;在实时包装器视图中保留内部 store 代理 |
| 列表回调 | 身份型:值/访问器;位置型:访问器/数字;自定义键:访问器/访问器 |
| Flow 主体 | 在 JSX/compute 中读取访问器;回调主体用于构建结构 |
| DOM | 小写 HTML 属性、class 数组/对象、回调 ref;动态判断放在事件回调内部 |
| SSR | 每个请求各自拥有用户状态;异步数据源;惰性代码会阻塞 shell,动态数据遵循边界/选项 |
| 服务端验证 | 函数指令:主体负责验证;模块指令:导出的包装器值会被注册 |
| 传输 | 声明使用 GET/withMeta,会话策略使用 prepareRequest,单次调用取消使用 invoke |
React 的重新渲染/依赖数组模型,以及 Solid 1.x 的同步写入、单回调 effects、resource 标志和旧导入路径,都需要进行语义审查。 报告可疑标识符前,请先根据实际导入和已安装类型进行核实。回调/访问器 prop 可能是有意设计;请依据其消费者合约说明问题。
有关 v1 的导入/重命名细节,请使用已安装的 solidjs-v2-migration 技能中的映射。
有关详细语义,请使用已安装的 solidjs-v2 技能及其任务路由器。
如果这些配套技能不可用,请根据已安装的类型定义和上游源码进行核实。即使单独使用,此检查清单仍然适用。
报告
只报告有证据支持的问题:严重程度、文件/行号、具体失败行为,以及最小正确修改。将运行时故障与开发诊断、风格选择分开说明。注明运行过哪些类型/运行时检查,以及哪些内容仍未验证。
评论
支持 Markdown