内容
# 🎮 Roblox 开发技能 — Roblox 开发的 AI 编程助手
专为 Luau 的 Roblox 游戏开发专家级 AI 技能。设计用于 [Claude Code](https://claude.ai), [Antigravity IDE](https://antigravity.dev),
以及任何支持 Skills 格式的 AI 编程助手。
> **最后更新：** 2026 年 6 月 25 日 | **引擎版本：** v727+ | **知识状态：** 2026 年中期最新
## 什么是本技能？
一个结构化的知识库，可以将您的 AI 编程助手转变为 **Roblox 开发专家**。当您提到与 Roblox 相关的任何内容时，技能会自动触发，并为 AI 提供有关 Roblox 平台的深入、准确、经过研究验证的知识。
### 主要功能
- 🧠 **4,900+ 行** 精选的 Roblox 开发知识
- 🔄 **自我更新** — 内置每周新鲜度检查，带有 `/roblox-update` 命令
- 🎯 **智能路由** — 根据您的意图自动选择正确的参考资料
- 🔌 **MCP 集成** — 与官方 Roblox Studio MCP 服务器配合使用
- 🛡️ **安全优先** — 服务器权限、输入验证、防 exploit 模式
- 📚 **迁移感知** — 指导您完成废弃的 API 和重大更改
- ⚡ **Context7 回退** — 当本地知识不足时，查找最新的 API 文档
## 目录结构
```
roblox-dev/
├── SKILL.md # 主要技能文件（路由器 + 标准 + 工作流程）
├── metadata.json # 知识更新跟踪（时间戳、版本）
├── README.md # 本文件
├── references/ # 深入参考指南
│ ├── luau-fundamentals.md # Luau 语言、类型、命名、样式
│ ├── project-structure.md # 架构、Rojo、Script Sync、IAS
│ ├── datastore-persistence.md # DataStoreService、ProfileStore、存储限制
│ ├── networking.md # RemoteEvents、客户端-服务器、复制
│ ├── security-hardening.md # 防 exploit、BanAsync、服务器权限
│ ├── performance-optimization.md # 内存、并行 Luau、性能分析
│ ├── mcp-integration.md # Roblox Studio MCP 工具和工作流程
│ ├── ui-systems.md # GUI、UIShadow、StyleQuery、UICorner
│ ├── legacy-migration.md # 废弃的 API、Scoped UserIds、迁移
│ └── monetization.md # Transfers API、游戏通行证、发布
└── evals/
└── evals.json # 技能触发准确性测试用例
```
## 安装
### Claude Code（主要）
```bash
# 克隆到您的全局技能目录
mkdir -p ~/.claude/skills
cd ~/.claude/skills
git clone https://github.com/YOUR_USERNAME/roblox-dev-skill.git roblox-dev
```
### Antigravity IDE / Gemini
```bash
# 从 Claude 目录符号链接（单一事实来源）
mkdir -p ~/.gemini/config/skills
ln -s ~/.claude/skills/roblox-dev ~/.gemini/config/skills/roblox-dev
```
或直接安装：
```bash
mkdir -p ~/.gemini/config/skills
cd ~/.gemini/config/skills
git clone https://github.com/YOUR_USERNAME/roblox-dev-skill.git roblox-dev
```
### 验证安装
当您在 AI 助手的可用技能列表中看到它时，技能处于活动状态。
测试方法：询问 *"为我的 Roblox 游戏创建一个硬币收集系统"* — 技能应该自动触发并生成具有 `--!strict` 模式的服务器授权 Luau 代码。
## 用法
### 自动触发
当您提到与 Roblox 相关的主题时，技能会自动激活：
- `Roblox`、`Luau`、`Roblox Studio`、`DataStoreService`、`RemoteEvent`
- `ProfileStore`、`Rojo`、`rbxl`、`rbxlx`、`游戏通行证`、`obby`、`tycoon`
- 任何 Roblox 引擎 API 参考
### 手动命令
| 命令 | 描述 |
|---------|-------------|
| `/roblox-update` | 从最新的 Roblox 文档触发完整的知识刷新 |
| *"更新 Roblox 技能"* | 知识更新的自然语言替代方案 |
### 与 Roblox Studio MCP 配合使用
如果您已连接官方的 [Roblox Studio MCP 服务器](https://create.roblox.com/docs)，
则技能可以：
- 直接在 Studio 中读写脚本
- 执行 Luau 代码进行验证
- 搜索游戏树
- 运行播放测试并读取控制台输出
- 捕获截图进行视觉验证
## 知识更新系统
技能包含一个 **自我监控的新鲜度系统**：
1. 每次触发时，它都会检查 `metadata.json` 中的 `last_updated` 时间戳
2. 如果已超过 7 天，则提醒您运行更新
3. 更新遵循严格的协议：**研究 → 事实核查 → 问答 → 应用 → 审计**
4. 所有决定都需要用户批准 — AI 永远不会自动更新
### 手动更新
说 `/roblox-update` 以触发立即的知识刷新。
## 涵盖的内容（2026 年中期）
| 主题 | 状态 |
|-------|--------|
| Luau 语言（严格模式、类型、泛型、`task` 库） | ✅ 当前 |
| 项目架构（服务、MVC、模块模式） | ✅ 当前 |
| DataStore + ProfileStore（会话锁定、限制、超额） | ✅ 2026 年 4 月 |
| 客户端-服务器网络（RemoteEvents、复制） | ✅ 当前 |
| 安全（服务器权限、Client Beta、BanAsync、exploit） | ✅ 2026 年 6 月 |
| 性能（并行 Luau、内存、Microprofiler） | ✅ 当前 |
| MCP 集成（内置原生服务器、26 个工具） | ✅ 2026 年 6 月 |
| UI 系统（UIShadow、StyleQuery、每个角的 UICorner） | ✅ 2026 年 6 月 |
| 旧版迁移（12+ 废弃的 API、Scoped UserIds 2026 年 10 月） | ✅ 2026 年 6 月 |
| 货币化（Transfers API、Roblox Plus、发布费） | ✅ 2026 年 5 月 |
## 贡献
欢迎贡献！请遵循以下准则：
1. **基于研究** — 所有内容必须基于官方 Roblox 文档
2. **无即兴发挥** — 如果您不确定，请将其标记为问题而不是猜测
3. **更新 `metadata.json`** — 增加版本号并添加更改日志条目
4. **运行评估** — 使用 `evals/evals.json` 验证触发准确性
5. **保持格式一致** — 所有代码示例中的 `--!strict`、API 的 PascalCase
## 许可证
MIT 许可证 — 参见 [LICENSE](LICENSE) 了解详情。
## 致谢
- **创建者**：由人类 + AI 合作构建（研究驱动、事实核查）
- **来源**：[Roblox Creator 文档](https://create.roblox.com/docs)、
[Luau 语言](https://luau.org)、[Roblox DevForum](https://devforum.roblox.com)、
[Roblox Lua 风格指南](https://roblox.github.io/lua-style-guide/)
- **技能格式**：由 [Anthropic](https://github.com/anthropics/skills) 开创
MCP 市场