SuperAPI AI 工具集

remix

编程与开发

查看项目

更新于 10-16 06:22

技能介绍

用途:该技能用于构建、审查和重构 Remix 3 应用,使用 remix 包与 remix/* 导入,覆盖应用结构、路由、中间件、数据、认证与 UI 等场景。

主要能力与心智模型:Remix 构建在 Web API(Request、Response、URL、FormData)之上,API 在运行时显式组合,不假设文件式路由、生成的路由类型或强制构建步骤。应用通常把路由拆为三部分:路由(定义 URL 与方法契约,如 app/routes.ts)、路由器(连接路由、中间件与控制器,如 app/router.ts)、控制器(实现匹配路由的处理逻辑,如 app/actions/)。这些部件可组合可替换,采用其一不必采用其他。

组件:Remix 组件使用 JSX,但不是 React。组件的 setup 函数每个实例只运行一次并返回渲染函数,setup 中的局部变量在渲染间保存状态,事件处理器修改状态后调用 handle.update() 请求重新渲染。渲染时从 handle.props 读取变化的 props,不要套用 React Hooks 或生命周期假设。事件处理器仅在浏览器挂载或水合后运行,纯服务端渲染的 HTML 本身不可交互。

使用方式:先阅读相关已安装文档,再接触不熟悉的 API。查看应用的 AGENTS.md、package.json、tsconfig.json,并检查负责待改行为的代码。可按任务、导出或关键词搜索 node_modules/remix/INDEX.md,例如 grep -i 'session' node_modules/remix/INDEX.md,再沿索引找到相应指南与包 README 的精确导入、选项、行为和示例;若无相关指南,则用 API README 与现有应用模式。已安装文档视为权威,包括与本技能冲突时。不要依赖记忆中的 Remix 2 模式或更新版本的在线 API。若安装无索引,检查其 package.json exports 及匹配的已安装 README、源码与类型。

注意:改动应保持最窄行为归属,保留应用的包管理器、脚本、运行时、中间件顺序与导入约定,除非任务要求更改;优先使用 Web API、原生链接/按钮/表单及已有 Remix 原语,而非自定义抽象;把浏览器可达模块视为公开,避免其中出现机密与可信服务端逻辑。验证方面,使用应用脚本运行测试与类型检查,并直接验证改动行为;UI 改动需在浏览器中操作交互,而非只看渲染外观;涉及不可信输入或访问控制的改动要测试拒绝与失败路径;结构性或配置变更后运行 remix doctor,应用修复前先审阅结果,不要为让诊断通过而运行破坏性数据库命令或改写配置。应报告已检查内容与仍未验证的部分。安装方式、版本等细节暂未提供。