SuperAPI AI 工具集

roblox-luau-developer

编程与开发

查看项目

更新于 10-15 21:08

技能介绍

用途:实现、审查和重构 Roblox Luau 代码,诊断运行时问题,并同步 Rojo 管理的代码库。默认前提是 Luau 与 Roblox 服务端/客户端模型。

主要能力:先识别项目形态——Rojo 项目(default.project.json 或 .project.json,工作流见 references/rojo-workflow.md)、Studio 导出(.rbxlx、.rbxmx、.model.json、src/、ReplicatedStorage/、ServerScriptService/)或 roblox-ts 项目(tsconfig.json、rbxtsc、@rbxts/,.ts 为源、out/ 为构建产物)。编辑前用 rg 搜索服务、模块、Remote 名、Attribute 名和 CollectionService 标签,梳理 ServerScripts、LocalScripts、ModuleScripts 的调用方向。

使用方式:保持服务端/客户端分层,权威状态与校验在服务端,客户端负责输入、显示、预测与请求;Remote 参数需做类型与权限检查;DataStore 写入需节流、重试与失败处理。优先小改动,保留模块返回结构、服务名与 require 风格。调试按 references/gameplay-debugging.md 处理运行时、复制、性能、DataStore 与 UI 不更新问题;UI 布局、焦点或屏幕生命周期问题交给 roblox-ui-developer。

限制与注意:客户端输入不可信,服务端须校验每个 remote 参数的类型与范围;LocalScript 放置位置决定客户端代码是否运行;使用 task.wait、task.spawn、task.delay,避免已弃用的 wait、spawn、delay;先设属性再设 Parent;加入后对未复制对象用 parent:WaitForChild("Name");连接对象需在销毁时断开,单次调用用 :Once;RemoteFunction 会阻塞调用方,优先单向 RemoteEvents。验证优先使用 selene、stylua、luau-lsp、lune、rojo 或项目脚本,并区分 Studio 执行、静态检查、已准备未运行与未验证。输出应说明改动脚本与行为、服务端/客户端边界、Remote/DataStore 风险及实际运行的验证。