SuperAPI AI 工具集

unreal-skill

智能体与模型

查看项目

更新于 10-15 21:38

技能介绍

用途:该技能面向 Unreal Engine Agent Skill 的编写与审查。Agent Skill 是注册到 unreal-mcp 服务器的具名指令包,用于向智能体提供其原本不知道或需特别关注的知识,可涵盖领域最佳实践、特定工作流或两者混合。

主要能力与原则:编写技能需遵循若干原则——内容应新颖(工具无法自行获知)、以向懂 Unreal 的同事简报的口吻书写、形式灵活(概念说明或分步指令)、避免嵌入会随时间变化的属性名或工具名、不引用编排系统或模型名等基础设施、精简到只保留必要且长期有效的内容。

使用方式:动笔前先通过 MCP 调用 ListSkills 查看项目中已注册的技能,再用 GetSkills 查看相关技能,若已覆盖则指向现有技能。实现路径有两种:Python 类适合属于代码插件的技能,用 @agent_skill 装饰并继承 unreal.AgentSkill,类文档字符串作为 Description,instructions 类属性承载指令,技能在导入时自动注册,通常放在插件 Python 包的 skills/ 子文件夹并在 init.py 中显式导入;UAsset 适合项目专属、无需代码的技能,通过 MCP 的 AgentSkillToolset 调用 CreateSkill(FolderPath、AssetName、Description、Details)或 UpdateSkill(SkillPath、Description、Details)创建与更新。

审查与限制:完成后用 GetSkills 检查,分别以智能体视角阅读 Description 与 Instructions,确认描述能说明适用时机、指令能提供工具无法教的内容且足够简短。编辑 Python 技能后需重载插件包,先在 Edit → Project Settings → Plugins → Python 启用 Remote Execution,再运行 python Engine/Plugins/Experimental/ToolsetRegistry/Content/Python/toolset_registry/tests/reload_remote.py your_plugin。智能体通过 unreal-mcp 元工具(list_toolsets、describe_toolset、call_tool)在运行时发现工具,因此指令不应写死工具集列表。