Scenario Agent Skills 是一套开源的 AI Agent 技能合集：装上之后，Claude Code、Cursor 等任意 AI 代理就能通过 Scenario MCP 服务器一键生成可直接进引擎的游戏资产——精灵图动画、PBR 贴图、无缝天空盒，乃至一张照片变成的可走可互动的 3D 房间。每一步生成都先报价、后执行，新手也能放心控制预算。

🧰 先认识工具：什么是 Scenario Skills

Scenario Agent Skills（见 README.md）把"怎么做"写成一个个技能文件（SKILL.md），Agent 按需加载，覆盖 500+ 模型的图片、视频、3D、音频生成，另外还有能驱动 Blender、Maya、ZBrush、Unity、Unreal、Godot 的专家技能组。

对新手最重要的，是它统一的核心生成循环——所有游戏资产技能都构建在这几步之上（详见 skills/scenario/SKILL.md）：

💡 你只需用自然语言提需求，Agent 会自动走完全程——这就是"一键"的含义。

⚡ 两步上手：一键安装与 MCP 连接

第一步，安装技能（以游戏资产常用的核心组合为例）：

npx skills add scenario-labs/skills --skill scenario --skill scenario-game-assets --skill scenario-sprite-animation --skill scenario-textures --skill scenario-skyboxes --skill scenario-3d --skill scenario-walkable-room

按角色分组的完整安装命令（含风格一致性、模型训练等配套技能）见 README.md 与 INSTALL.md；也可以git clone https://gitcode.com/gh_mirrors/skills63/skills把仓库拉到本地浏览。

第二步，连接 Scenario MCP 服务器：

claude mcp add --transport http scenario https://mcp.scenario.com/mcp

其他 MCP 客户端（Cursor、VSCode 等）把同一个地址加入配置，用 Scenario 账号 OAuth 登录即可。

装好后，直接对 Agent 说这些自然语言就能开工：

• "生成 4 个风格一致、透明背景的治疗药水图标，用于我的 RPG 物品栏"
• "做一张无缝砖墙贴图，再放大到 2048 且不能破坏平铺"
• "把这个概念草图变成 3D 道具，导出 GLB 之前让我先预览"

🎮 精灵图生成：从一句需求到引擎可用的动画

scenario-sprite-animation 技能内置多条"车道"，Agent 按任务需要自动选路：

整表交付后还有一整套自动工序：

1. 切帧：内置裁切工具最多支持 6×6 网格，逐格检查边缘与姿态（16 帧按 4×4 排布，而不是 2×8）；
2. 对齐：逐格测量身体基线，把所有脚踩到同一条线上——这是后处理步骤，不靠提示词硬撑；
3. 像素清理：网格对齐 + 调色板量化，保证像素风不"糊边"；
4. 打包：拼回精灵表、导出透明背景 PNG（JPG 没有 alpha 通道会被明确避开）；GIF 预览帧率取 10/20/25 这类能被 100 整除的值，避免掉帧。

想要多方向行走/奔跑/攻击循环（俯视角、等距、侧视），走 directional-cycles 车道：从你自己的角色图出发，逐方向生成、抠像、拼表，一直做到引擎导入。

风格一致性是整批资产的关键：复用同一个seed、固定提示词模板、上传美术参考图锁风格；项目风格锁定后还可以用scenario-model-training训一个自己的 LoRA。做横版像素游戏整包（主角 + 敌人 + 关卡层）则有专门的 scenario-side-view-game-kit，一次会话出完跑动、攻击、受击等全部循环，外加视差背景层与无缝墙体贴图。

🎨 PBR 贴图：无缝平铺与完整五图材质

scenario-textures 覆盖从平面纹理到 PBR 材质的全流程：

• 无缝平铺纹理：一句 "seamless weathered brick wall" 生成 1024×1024 贴图，eraseSeam选项修补接缝；验收有硬性标准——2×2 自拼接验证图能立刻暴露任何接缝；
• 不破平铺的放大：纹理专用放大模型支持 2x–8x，普通放大器会在接缝处"撕开"平铺，它不会；
• 完整 PBR 五图：一张平面贴图经一次图像编辑，即可拆出基础色、法线、粗糙度、金属度、高度五张图，各自独立成资产，直接进引擎；
• 引擎尺寸：刻意选 1024、2048 这类 2 的幂尺寸，避免引擎导入时的重采样问题。

如果对象是已有网格（比如图生 3D 的结果只有扁平色），走 scenario-patina-retexture：

1. 在 Blender 里清点材质，按物理表面分成"材质族"（石膏、雪松木、釉面陶瓷……）；
2. 每个族生成一套无缝 PATINA 材质（五图齐全，固定种子可复现）；
3. 自动写入 Blender 材质节点——顶点、面、变换一个都不动；
4. 可选：沿同一相机路径渲染改造前后对比片，只变材质、其余都不变。

🌌 天空盒生成：360° 无缝全景环境

用普通图像模型硬要一张 "360 panorama"，边缘不包边、极点糊掉——所以 scenario-skyboxes 坚持走专用天空盒模型：

• 等距圆柱 2:1 全景：自动校正接缝与极点几何，一句 "ancient pine forest at dawn, mist between trunks, god rays" 直接出图；
• 风格迭代：复用最佳结果的seed只换风格预设（电影感、油画、赛博朋克……），或低强度（0.2–0.4）传参考图——保构图、换气质；
• 不破缝放大：2x–8x 天空盒专用放大，包边连续性不受影响；
• 导出进引擎：等距圆柱全景直接给 Unity / Unreal / Godot 使用，也可按 6:1 立方体条带等布局导出；
• 免费验收：比较输出 PNG 最左与最右像素列，无缝全景两者差异接近于零，接缝问题一眼看穿。

顺带一提：生成好的全景还能进一步交给scenario-3d-worlds变成可导航的 3D 高斯泼溅场景——这正是下一节的起点。

🚪 可走可互动的 3D 房间：一张照片到可进入的世界

这是整套技能里最"炫"的一条管线：scenario-walkable-room。一张室内照片（上传或先生成）会变成浏览器里走进去的房间：墙壁在相机背后完整重建，桌上的小物件变成可以拿起来、扔出去、听见落地声的真实 3D 模型。

七步流水线，生成全部走 MCP，组装在本地完成：

先对照片做风格改造，还能让同一间房以多种装修风格出现。Web 端会自动简化网格（约 1.5–2 万三角形、1K WebP 贴图）保证流畅加载。

💰 花费管理：每笔 AI 生成都先报价

新手最担心的"AI 烧钱"，这套技能有系统性答案：

• dry_run报价制：任何付费生成前都先精确报价，批量任务先报总账再开工；失败的作业一般自动退款（个别受内容审核中断的除外）；
• 用量分析：scenario-admin-analytics 把 MCP 用量数据变成答案——Top 模型、每人每模型的 CU（Creative Unit）消耗、月度趋势、CSV 导出、带图表的 PDF 报告，以及本地离线仪表板（模板见 skills/scenario-admin-analytics/assets/dashboard.html）。

下面两张是仓库内置示例数据的仪表板截图（虚构数据，仅演示渲染效果）：

筛选视图支持按日期、模型、身份组合过滤，适合追踪某个游戏项目的 AI 资产支出：

✅ 新手速查清单

1. 装技能：npx skills add scenario-labs/skills，菜单选择或按角色包整装；
2. 连 MCP：把https://mcp.scenario.com/mcp加进客户端，OAuth 登录；
3. 先报价：养成"先dry_run再执行"的习惯，预算心里有数；
4. 看验收标准：纹理做 2×2 自拼、天空盒比左右边缘列、精灵表数格子——这些免费检查都写在技能里；
5. 再进引擎：PNG 保透明、贴图用 2 的幂尺寸、GLB/FBX 下载直进 Unity / Unreal / Godot。

小结

Scenario Agent Skills 把"AI 出图"升级成"AI 交资产"：精灵图动画、PBR 贴图、无缝天空盒、3D 道具 与 可交互 3D 房间 各有一条验证过的工作流，全部先报价后执行。装好技能、连上 MCP，一句自然语言就能开始你的游戏资产生产线。