关于 asset-transformer-toolkit
面向使用 Asset Transformer Toolkit 4.0.0 或更高版本的 Unity 项目,指导 Agent 按文档 API 处理导入器、RuleSet、动作和细节层级,并先检查版本、避免不支持的访问方式。
主要功能
- 01开始前检查工具包版本
- 02使用文档化的 ATTAssistantUtilities API
- 03创建导入器及重新导入指南
- 04RuleSet、动作和细节层级参考
适用场景
- 01确认 Unity 项目是否满足版本要求
- 02使用工具包导入器创建或重新导入模型
- 03处理 RuleSet、动作或细节层级
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ unity-technologies/ skills --skill asset-transformer-toolkit安装后在 Claude Code 中输入/asset-transformer-toolkit确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
SECURITY.mdapi-docs/rule-api.mdruleblock-api.mdruleset-api.mdreferences/create-importer.mdlods.mdrulesets-and-actions.md详细介绍
开始之前:检查软件包版本
此技能需要 Asset Transformer Toolkit 4.0.0 或更高版本(com.unity.industry.toolkit)。更早的版本没有以下每个工作流都依赖的 ATTAssistantUtilities API。
- 从
Packages/packages-lock.json中读取com.unity.industry.toolkit的解析版本(如果没有,则查看Packages/manifest.json)。 - 未安装: 告知用户此工作流需要 Asset Transformer Toolkit 4.0 或更高版本。这是一个需要授权的 Unity 软件包,用户可能需要通过其 Unity 方案获取访问权限,然后停止。不要自行将其添加到清单中。
- 已安装但低于 4.0.0: 告知用户找到的版本以及所需的 4.0 或更高版本,并在升级前征求同意。不要回退到较旧的 API,不要使用针对内部类型的原始 C#,也不要使用反射。
- 4.0.0 或更高版本: 继续。
API 参考
工具函数由 Unity.Pixyz.Plugin4Unity.Editor.AI.ATTAssistantUtilities 提供。每个参考文件中都附有内联文档,介绍这些函数及其操作的类。
技术说明
Pixyz Plugin 是 Asset Transformer Toolkit 以前使用的名称。除非用户使用“Pixyz”一词,否则优先使用“Asset Transformer Toolkit”来称呼它。 大多数类和代码都位于 Unity.Pixyz.Plugin4Unity.Editor 程序集中。 Asset Transformer Toolkit 与 Asset Transformer Studio/Pixyz Studio 并非同一产品。切勿依赖有关 Asset Transformer Studio 的信息。
导入器
Asset Transformer Toolkit 可以从项目外部导入 3D 文件。 修改导入器时,切勿假设修改后应立即重新导入。导入过程可能很漫长,因此只有在用户提出请求时才能启动。 使用 ScriptableObject API 修改导入器中的字段。切勿使用反射访问或修改导入器字段——此处无法使用反射。 要创建用于导入文件的 Pixyz/Asset Transformer Toolkit 导入器,或使用现有的 ImporterScriptableObject 重新导入模型,请阅读 references/create-importer
规则集和操作
阅读 references/rulesets-and-actions
需要 RuleSet API 时,请阅读 api-docs/ruleset-api。
需要 Rule API 时,请阅读 api-docs/rule-api。
需要 RuleBlock API 时(包括在构造 RuleBlock 实例时使用 ActionBase.Id),请阅读 api-docs/ruleblock-api。