Unity-Skills

环境要求

• Unity 2022.3+（官方维护基线，未来适配 2022.3+ / Unity 6）
• 一个支持 Agent Skills 的 AI 终端工具，如 Claude Code、Codex、Cursor、Antigravity、Kimi Code、Ope
• Unity 项目可正常打开并可访问 Package Manager
• 手动安装时需能访问本项目 UPM 包内的 SkillsForUnity/unity-skills~/ 目录

安装与启动步骤

1. 1安装 Unity 插件

   在 Unity 中打开 Package Manager，选择 Add package from git URL，粘贴稳定版 Git URL 安装。

   https://github.com/Besty0728/Unity-Skills.git?path=/SkillsForUnity

   复制

2. 2打开技能窗口

   在 Unity 菜单栏点击 Window > UnitySkills，打开插件主界面。

3. 3一键安装技能

   切到 AI Config 标签，选中对应终端图标后点 Install，安装器会自动把包内 unity-skills~/ 模板复制到目标位置。

4. 4手动安装技能

   若工具不支持一键安装，可把包内 SkillsForUnity/unity-skills~/ 全部内容复制到该工具的 Skills 根目录，并重命名为 unity-skills。

5. 5写入 agent 配置

   在 unity-skills/scripts/ 下新建 agent_config.json，agentId 填你的 AI 工具名（如 claude-code、codex、cursor）。

   {"agentId": "your-agent-name", "installedAt": "2026-02-11T00:00:00Z"}

   复制

6. 6重启并验证

   重启 AI 工具让其重新加载 Skills 列表，再触发一次 Skills 列表或简单技能调用确认可用。

关键配置

如何确认成功

在 AI 工具中触发 Skills 列表/命令，或执行一次简单技能调用，能正常识别并响应即安装成功。

常见问题

注意事项

• 官方维护基线为 Unity 2022.3+，未来功能与回归测试聚焦 2022.3+ / Unity 6。
• 升级包后已安装工具会自动同步到新版本，可在 ⚙ Settings ▸ AI Tools 关闭该行为。
• 手动安装后目录结构需保持 unity-skills/SKILL.md、skills/、references/、scripts/unity_skills.py、scripts/agent_config.json。
• 一键安装会在安装界面复制模板，无需手工拷贝文件。