第6章 Spline Agent Skill:让 AI 精准驱动 3D 设计
Spline Agent Skill
Spline MCP Server 让你的 AI 编程工具能够驱动 Spline,而 Spline Agent Skill 则让它知道什么时候该这么做——以及如何第一次就做对。
没有这个技能时,你让 agent 做一个"可交互的 3D Hero",它通常只会凭记忆直接写代码。有了它,agent 会明白:如果后续需要有人维护这个结果,可编辑的 Spline 文档才是更好的选择;而且它在调用工具之前,就已经了解 Spline 的创作规范。
这个技能是可选的。MCP server 没有它也能正常工作——它主要是帮 agent 在一开始就选对 Spline,省去摸索工具界面的试错过程。
它涵盖什么
什么时候用 Spline,什么时候手写 Three.js 或纯标记代码——判断标准是"谁来维护结果",而不是"agent 能做什么"。
如何识别自己还没连接 Spline,并明确告诉你,而不是悄悄回退到生成代码。
如何路由到正确的工具面——3d_* 用于场景、网格、相机和光照;2d_* 用于 Hana 设计、应用界面和 UI。
创作规范——每个工具面在第一次真正编辑前都需要先调用 load_skill,这是 agent 无法凭猜测知道的。
交接循环——编辑前先重新读取文档,因为你可能在上次调用之后又在画布上改动了内容。
安装
在 ChatGPT 和 Codex 中,这个技能随 Spline 插件和托管版 MCP server 一起提供,无需另外安装。
面向 Cursor 和 Claude Code 的 Spline 插件还在等待应用市场审核。在正式上架之前,请手动连接 server(参见 Connect your AI tool),并按照下文说明添加技能。
技能本身就是一个 SKILL.md 文件,发布在公开的 Spline 插件仓库的 skills/spline/SKILL.md 中。托管版 server 和桌面应用都支持它。
Claude Code
把它保存到你的个人技能目录,即可在所有项目中使用:
mkdir -p ~/.claude/skills/spline && curl -fsSL https://raw.githubusercontent.com/splinetool/spline-skills/main/skills/spline/SKILL.md -o ~/.claude/skills/spline/SKILL.md
也可以提交到单个项目的 .claude/skills/spline/SKILL.md,让整个团队共享。保存后重启 Claude Code 即可加载。
其他工具
支持 Anthropic 风格 Agent Skills 的工具可以直接使用该文件。对于使用规则或指令文件的工具(例如 Cursor 的 project rules),把 SKILL.md 的内容粘贴进去即可。内容是纯 Markdown,不含任何工具特定的语法。
如果你的工具支持 frontmatter 的 description 字段,请保持原样。这一行是 agent 判断是否加载技能的依据——没有它,技能可能永远不会被触发。
验证效果
问你的 agent 一个它平时会用代码回答的问题:
在我的落地页上添加一个可交互的 3D Hero。
如果技能已加载且 Spline 已连接,它应该会提出创建一个可编辑的 Spline 场景,并先加载创作指南,而不是直接写一个 Three.js 组件。如果尚未连接,它应该明确告诉你并提供替代方案,而不是悄悄替你做决定。
ChatGPT 和 Codex——在 ChatGPT 或 Codex 中添加 Spline 插件,在聊天窗口内直接打开的 Spline 编辑器中构建 3D 场景和设计。
Spline Arena——对 AI 模型用同一提示词在 Spline 中生成的 3D 场景盲投投票,查看公开排行榜,领取免费 AI 额度。