mcpField
S
setup-roblox-skills

setup-roblox-skills

github.com/ashexplainedAgent 工作流3896 次安装17 周前更新
代码仓库

关于 setup-roblox-skills

setup-roblox-skills 是一个由提示词驱动的配置技能，用于将 Roblox 技能包接入游戏项目，设置生命周期指引、技能路由、跟踪器规范、分诊标签和 UI 设计产物位置。

主要功能

  1. 01检查现有项目规范
  2. 02配置生命周期与技能目录
  3. 03设置后续技能路由指引
  4. 04设置跟踪器与分诊配置
  5. 05定义 UI 设计产物布局

适用场景

  1. 01将 Roblox 技能接入现有游戏
  2. 02选择本地或 GitHub 工作跟踪器
  3. 03记录项目专用分诊标签
  4. 04为 UI 设计简报指定存放位置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ashexplained/roblox-skills --skill setup-roblox-skills

安装后在 Claude Code 中输入/setup-roblox-skills确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

claude-block.md
design-artifacts.md
tracker-github.md
tracker-local.md
triage-labels.md

详细介绍

设置 Roblox 技能

将 Roblox 技能包接入特定游戏项目，让每项技能都了解其生命周期、相关技能，以及项目的工作跟踪位置，并确保每项技能结束时都会建议接下来运行什么。

这是一项由提示词驱动的技能，不是脚本。先探索、提几个简短问题、确认，然后再写入。

**跟踪器用于规划，不用于存放代码。**游戏的 Luau 代码和实例位于 Roblox 云端体验中，并通过 Studio MCP（roblox-studio-workflow）进行编辑——绝不提交到 Git。Git / 跟踪器只保存规划文档：ROADMAP.md、PRD、切片和 UI 设计简报。设置时要明确说明这一点。

写入内容

  1. 在项目的 CLAUDE.md 中加入一个 ## Roblox Skills 区块，其中包含：
    • 游戏开发生命周期图（各阶段 → 每个阶段运行哪些技能）；
    • 技能目录——每项技能的一句话用途、适用时机和触发词；
    • 下一项技能的路由约定：任何技能结束时，都要告诉用户接下来运行哪项技能。 规范区块见 claude-block.md——原样注入（移除本项目未安装的任何技能目录）。
  2. docs/agents/ 配置文件：跟踪器、分类标签和 UI 设计文档布局。

流程

1. 探索

查看现有内容——不要想当然：

  • git remote -v — 这个游戏项目是否为 GitHub 仓库？
  • 根目录下的 CLAUDE.md — 是否存在？是否已有 ## Roblox Skills 区块？
  • ROADMAP.md、roadmap/、.roblox/ — 是否已在使用本地路线图 / 跟踪器约定？
  • docs/agents/ — 之前的运行是否已写入配置？
  • design/ — 是否已有 UI 设计简报？
2. 提问（一次一个）

假设用户可能是新手。先用一句话解释，再给出选项和默认值。

A — 工作在哪里跟踪？ roblox-to-issues 生成的切片和 roblox-triage 处理的错误都需要一个归档位置。

  • 本地路线图（默认，Studio 优先） — 用 ROADMAP.md 作为索引，并在 roadmap/<feature-slug>/ 下存放 Markdown 文件。适合在 Studio 中工作的独立开发者，尤其是没有 Git 远程仓库的情况。根据 tracker-local.md 初始化。
  • GitHub issues — 使用 gh CLI，在项目的 GitHub 仓库中管理 issues。如果存在 GitHub 远程仓库，则建议此选项。根据 tracker-github.md 初始化。
  • 其他（Trello、Notion 等）——让用户用一句话说明，并以文字记录。

B — 分类标签。 五种规范状态（needs-triage、needs-info、ready-to-build、needs-human、wontfix）以及类别（bug、enhancement）。默认值与标签名称相同；仅当用户已在使用不同的字符串时才询问。根据 triage-labels.md 初始化。

C — UI 设计文档。 UI 切片必须在有已批准的设计简报后才能构建（见 roblox-game-ux）。确认文档布局（默认：在 design/features/<feature-slug>/ 下存放 Markdown 简报，可附参考图片 / 截图——Roblox UI 在 Studio 中构建，因此这些是规格说明，不是 HTML 样式包）。根据 design-artifacts.md 初始化。

3. 确认

向用户展示 ## Roblox Skills 区块和 docs/agents/*.md 文件的草稿。写入前允许用户修改。

4. 写入
  • 如果 CLAUDE.md 存在，则编辑它；如果不存在，则先询问是否要创建（如果用户倾向于使用 AGENTS.md，不要同时创建 AGENTS.md——编辑用户选择的文件）。
  • 如果已存在 ## Roblox Skills 区块，则在原处更新——不要重复追加，也不要覆盖周围的区块。
  • 从 claude-block.md 注入该区块。省略此处未安装的任何技能，不要凭空添加。
  • 根据选定的种子文件编写 docs/agents/tracker.md、docs/agents/triage-labels.md 和 docs/agents/design.md。
5. 完成

告知用户设置已完成，所有 Roblox 技能现在都会读取此部分来了解生命周期和路由方式；之后他们可以编辑 docs/agents/*.md，无需重新运行此技能。

下一步

使用 roblox-game-development-lifecycle 开始（或继续）游戏开发，它会读取此部分以查找当前阶段并路由到合适的专家。对于全新的游戏，请使用 roblox-game-ideas。

评论

支持 Markdown