前言¶
做 Unity 项目时,菜单层级深、Inspector 字段多、中英文界面混用,常见问题往往不是「文档里没有」,而是「不知道从哪一步点进去」。翻官方 Manual 容易停在概念说明,搜论坛帖子又容易版本对不上。下面介绍 SkillHub 上的 Unity 操作向导:在用户问编辑器怎么用、组件怎么配、设置怎么改、报错怎么查时自动介入,按问题给出可跟做的操作路径,而不是替代你写 C# 脚本。
这是什么¶
Unity 操作向导(坐标 @user_2aa4a621/unity-operation-wizard,版本 1.0.0)是社区发布的 education 类 Skill,面向 Unity 2022.3 LTS Editor。技能内带 Unity 编辑器知识库,说明里写明适合刚接触 Unity 的开发者熟悉界面与日常操作。
官方定位是:不是文档查询工具,而是操作向导。流程是:根据你的问题定位到相关系统 → 查阅技能内的参考材料 → 输出分步操作说明。并支持中英界面术语对照。明确不涉及 Editor 脚本编写。
发布页:SkillHub - Unity 操作向导。API 元数据地址:https://api.skillhub.cn/user_2aa4a621/unity-operation-wizard。标签 requires_api_key=false,使用时不依赖额外 API Key。
核心功能¶
以下能力均来自 SkillHub 页面与 API 简介,未超出已公开说明:
- 按场景自动激活:当问题涉及 Unity 编辑器操作、界面功能、组件配置、设置调整、问题排查时,Skill 会被触发,无需每次手动指定技能名。
- 操作路径而非摘抄文档:强调「逐步操作路径」,把「想做什么」落成「先点哪、再改哪」。
- 内置编辑器知识库:技能包内维护与 Unity 2022.3 LTS 编辑器相关的参考内容,供 Agent 在回答时检索并对齐步骤。
- 中英术语对照:便于在中文系统、英文菜单或混合环境下对齐 Inspector、Project Settings 等名称。
- 范围边界:覆盖编辑器使用与排错指引,不承担编写或修改 Editor 脚本的任务。
安装与启用¶
安装依赖 SkillHub CLI。官方安装说明见 skillhub.cn/install/skillhub.md。
1. 检查或安装 CLI¶
command -v skillhub && skillhub --version
若未安装,可按官方文档执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 识别的 skills 目录;默认装到 ./skills/ 可能不会被加载。
skillhub install user_2aa4a621/unity-operation-wizard --dir <你的 skills 目录>
常用路径(摘自官方安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可将官方提示词发给 AI,让其按上述文档安装 @user_2aa4a621/unity-operation-wizard:
请根据 https://skillhub.cn/install/skillhub.md,安装
@user_2aa4a621/unity-operation-wizard。
安装后若 Agent 未立即识别新技能,需按你所用客户端的说明重启或刷新技能列表(SkillHub 文档提示部分环境需重启)。
典型用法¶
Skill 无单独「命令行子工具」;用法是在已启用技能的对话里用自然语言描述编辑器侧需求。下列示例与官方激活条件一致,便于自测是否装对、是否触发:
界面与窗口
- 「Unity 里怎么打开 Package Manager,并确认当前项目用的是 2022.3 对应的包?」
- 「Scene 视图和 Game 视图分别用来做什么?我想调整摄像机预览该看哪个窗口?」
组件与 Inspector
- 「给空物体加 Rigidbody,Mass 和 Use Gravity 分别在哪、改完怎么在 Scene 里验证?」
- 「UI 按钮的 On Click 列表是灰色的,Inspector 里通常要先满足什么条件才能绑事件?」
项目设置与排查
- 「Build Settings 里 Switch Platform 之后还要检查哪些 Project Settings?」
- 「Console 报 Missing Script,在 Hierarchy 和 Project 里按什么顺序查比较快?」
期望回答形态是:带顺序的步骤、与 Unity 2022.3 LTS 菜单/面板名称一致,并在需要时给出中英文术语对应;若问题本质是写 Editor 扩展脚本,应落在 Skill 声明范围之外。
适用场景与注意¶
适合谁
- 正在用 Unity 2022.3 LTS 做项目或学习,需要有人「带着点界面」的开发者。
- 更熟悉中文提问、但编辑器为英文(或相反),需要术语对齐的情况。
- 希望减少在 Manual 与零散帖子之间跳转、只要编辑器操作清单的场景。
限制与注意
- 版本锚定在 2022.3 LTS;其他大版本菜单或包管理界面可能有差异,步骤需自行对照官方变更说明。
- 不写、不改 Editor 脚本;涉及自定义 Inspector、EditorWindow 等应另找编程向资料或 Skill。
- SkillHub 元数据显示:来源 community,分类 education;统计项以页面为准(如评分、下载次数会随时间变化,写作时 API 侧为评分 100000、下载 1093、安装 0,与简介中的能力描述独立,仅作商店参考)。
- 回答质量依赖 Agent 对 Skill 的加载与技能内知识库;复杂工程级架构问题仍建议结合官方文档与项目实际设置核实。
结尾¶
Unity 操作向导把「编辑器怎么用」收敛成对话里的分步指引:自动识别操作类问题、内置 2022.3 LTS 向知识库、中英术语对照,并明确不碰 Editor 脚本。若你主要在 Cursor 等环境里用 AI 辅助 Unity 学习或日常配置,可按 SkillHub 流程安装 @user_2aa4a621/unity-operation-wizard 后,用上一节这类问题试一轮流程是否符合预期。
官方入口:https://www.skillhub.cn/skills/user_2aa4a621/unity-operation-wizard