Luban

Luban 配置工具专家

概述

Luban 是一个强大、易用、优雅、稳定的游戏配置解决方案。本技能提供对 Luban 完整文档的索引和访问,帮助快速定位相关文档解决配置问题。

核心原则: 优先查阅文档,基于文档提供准确方案。

何时使用本技能

使用场景:

• 定义配置表结构 (schema)
• Excel 配置数据填写问题
• 生成多语言配置代码
• 数据校验和验证器使用
• 多态类型、自定义类型配置
• 本地化和多语言支持
• Roblox-ts 特定配置需求

不使用场景:

• 通用 TypeScript 问题
• Roblox API 问题(非配置相关)
• Git 操作问题

文档索引

快速开始

类型系统

Excel 配置

数据导入和生成

校验和验证

Schema 定义

高级特性

工具和扩展

运行时和集成

其他

工作流程

当用户提出 Luban 相关问题时:

1. 识别问题类型 - 使用上方索引表定位相关文档
2. 读取文档 - 使用 Read 工具读取相关文档(路径: .claude-plugin/skills/luban/docs/...)
3. 提供方案 - 基于文档内容提供准确解决方案
4. 示例代码 - 使用文档中的实际示例
5. 最佳实践 - 结合 bestpractices.md 提供建议

Roblox-ts 特定说明

本项目是 Luban 的 roblox-ts 定制版本:

  "repository": {
    "type": "git",
    "url": "git+https://github.com/WhiteDragonRoblox/roblox-ts-luban.git"
  },
  "author": "",
  "license": "ISC",
  "bugs": {
    "url": "https://github.com/WhiteDragonRoblox/roblox-ts-luban/issues"
  },
  "publishConfig": {
    "access": "public"
  },
  "homepage": "https://github.com/WhiteDragonRoblox/roblox-ts-luban#readme"

Roblox-ts 枚举特性（v0.6.3+）

枚举类型基于 value 属性自动检测：

数字枚举示例：

<enum name="ItemRarity">
    <var name="Common" value="1"/>
    <var name="Rare" value="2"/>
</enum>

→ 生成 Common = 1, Rare = 2

字符串枚举示例：

<enum name="GameState">
    <var name="Ready" value="ready"/>
    <var name="Active" value="active"/>
</enum>

→ 生成 Ready = "ready", Active = "active"

Roblox-ts Nominal 字段

Nominal 字段用于运行时类型识别，在 create 函数中硬编码：

<bean name="Entity">
    <var name="entityType" type="string" nominal="true" value="Entity"/>
    <var name="id" type="string"/>
</bean>

详细文档：README_ROBLOX_TS.md

常见问题关键词快查

根据用户问题关键词快速定位文档:

• "多态"、"继承"、"抽象类"、"子类"、"parent" → beginner/usepolymorphismtype.md
• "Excel格式"、"单元格"、"填写"、"列格式" → manual/excel.md
• "校验"、"验证"、"ref"、"path"、"range" → beginner/usevalidator.md
• "枚举"、"enum"、"字符串枚举"、"数字枚举" → beginner/usecustomtype.md + Roblox-ts 特定说明
• "本地化"、"多语言"、"翻译"、"l10n" → manual/l10n.md
• "生成代码"、"导出"、"编译" → beginner/generatecodeanddata.md
• "运行时"、"加载"、"反序列化" → beginner/loadinruntime.md
• "定义表"、"schema"、"beans"、"tables" → manual/schema.md
• "list"、"map"、"set"、"array"、"集合" → beginner/usecollection.md
• "自定义类型"、"bean"、"结构体" → beginner/usecustomtype.md
• "标签"、"tag"、"条件导出" → manual/tag.md
• "模板"、"自定义生成"、"scriban" → manual/template.md

重要原则

• ✅ 优先查阅文档 - 不凭记忆回答
• ✅ 使用实际示例 - 从文档中提取示例
• ✅ 完整路径 - 文档路径: .claude/skills/luban/docs/
• ✅ 中文回答 - 用户问题用中文回答
• ❌ 不编造信息 - 文档没有的内容诚实说明