用途:该技能为使用 Inertia.js 与 Ruby on Rails 构建应用提供最佳实践,适用于编写新的 Inertia Rails 控制器或页面、评审现有代码、将 Rails 应用重构为 Inertia、优化性能、实现认证授权、构建带校验的表单以及为 Inertia 响应编写测试。
主要能力:共 50+ 条规则,分为 8 类并按优先级排序。CRITICAL 级别包括服务端安装与配置、Props 与数据管理(可带来 2-5 倍性能提升并涉及安全);HIGH 级别包括表单与校验、导航与路由;MEDIUM-HIGH 级别包括性能优化(宣称页面加载快 30-70%)与安全;MEDIUM 级别包括测试与进阶模式。
使用方式:例如 Props 管理建议仅返回必要数据、使用共享数据承载全局属性、用 lambda 做惰性求值、为非关键数据使用 deferred props、实现部分重载、避免在 props 中暴露敏感数据、使用 as_json 序列化、必要时深度合并、对稳定数据使用 once props 以及用 prop transformer 统一命名(如 camelCase)。表单方面建议复杂表单用 useForm、简单表单用 Form 组件、正确传递校验错误、多表单页面使用 error bags、提交后重定向遵循 PRG 模式、正确上传文件、校验失败时保留表单状态、嵌套数据用点号表示法、用 precognition 做实时校验、非导航请求用 useHttp。导航建议内部跳转用 Link 组件、外部重定向用 inertia_location、合理使用 preserve-scroll 与 preserve-state、为链接配置正确 HTTP 方法、用 inertia 路由助手处理静态页面、正确处理 303 重定向、用 instant visits 提升观感。性能方面建议动态导入实现代码分割、预取可能的导航、配置 stale-while-revalidate 缓存、必要时才轮询、用 merge props 做无限滚动、优化进度指示、异步访问非阻塞操作、用 InfiniteScroll 组件分页、启用视图过渡。安全方面强调服务端认证、将授权结果作为 props 传递、用历史加密保护敏感数据、依赖 Rails CSRF 保护、服务端校验和清洗所有输入、控制器使用强参数。测试覆盖 RSpec 匹配器、Minitest 断言、部分重载与 deferred props、Capybara 端到端测试、重定向后 flash 消息及组件渲染验证。进阶模式包括持久化布局、自定义组件路径解析器、prop transformer、SSR、视图过渡、滚动区域、事件系统、布局 props 与 Vite 插件配置。每条规则的详细说明与代码示例参见 AGENTS.md。
适用场景与限制:主要面向 Rails 后端配合 React、Vue(描述中提及,未完整列出)等前端框架的 Inertia.js 项目。资料未提供收费、价格、平台限制或安装命令等其他事实。