SuperAPI AI 工具集

roblox-api

编程与开发

查看项目

更新于 10-17 16:13

技能介绍

roblox-api 是一个面向 Roblox 引擎 API 查询的技能,主要用于实现阶段的参考查找:当开发者需要确认某个能力由哪个引擎类或服务提供,某个成员是属性、方法、事件还是回调,某个数据类型或枚举的具体用法,或者某个全局名称与内置库的行为时,可使用本技能。

主要能力包括:查找拥有某项能力的类或服务;确认成员类型;核实数据类型构造器、属性、方法、常量或数学行为;选择属性或参数所需的正确枚举族与枚举项;查询 game、workspace、script、plugin、Enum 等全局名称;确认 task、math、string、table、os、vector 等内置库的行为;在编写代码前验证参数形状、返回值和弃用状态。

使用方式上,技能建议先明确缺失的事实(哪个引擎对象负责、需要哪种成员、期望哪种数据类型或枚举、哪个全局或库助手适用),再选择对应的参考文件:engine-overview.md 用于接口面选择,classes-reference.md 用于类、服务与成员查找,datatypes-reference.md 用于值类型及其用法,enums-reference.md 用于枚举族与项,globals-reference.md 用于 Luau 与 Roblox 全局,engine-library-yaml-files.md 用于内置库,datatype-yaml-files.md 用于解释数据类型 YAML 结构与重载。确认 API 契约时应核对成员名称、成员类型、参数顺序与类型、返回类型、属性类型、枚举族与项名称以及弃用等标签。

该技能还建议优先使用文档中的现代接口,例如用 task.wait() 代替 wait()、用 task.delay() 代替 delay()、在需要清晰时用 game:GetService() 访问服务;遇到重载时应阅读全部重载后再选择调用方式;当参数或属性类型指向其他数据类型或枚举时,应单独跟进确认。

适用场景主要是引擎参考查询,例如为射线检测选择正确的接口面(Workspace:Raycast、RaycastParams、Enum.RaycastFilterType、RaycastResult),确认补间动画调用(TweenService:Create、TweenInfo、Enum.EasingStyle 等),以及区分全局、数据类型和枚举的用法。

限制方面,本技能不适用于整体 Roblox 项目结构、代码放置或客户端-服务端职责划分(应交给 roblox-core),不适用于远程安全、复制架构、持久化设计或 Open Cloud 工作流(分别交给 roblox-networking、roblox-data、roblox-cloud 或 roblox-oauth)。当请求混合了参考查找与范围外的设计问题时,只回答引擎参考部分并明确排除其余内容。