进阶 docs.spline.design 2026-11-22 06:55:33 · 8 阅读

第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 额度。

评论 (0)