用途:生成并维护项目文档 .agents/ue-project-context.md,供其他 UE 技能自动读取,了解项目的引擎版本、模块布局、启用插件、编码约定、Gameplay 框架类、网络模型和构建目标。该技能只读取项目文件(.uproject、.Build.cs、.Target.cs、Config/Default.ini、Plugins//.uplugin),不调用任何引擎 API;除非用户明确要求,不应扫描 C++ 以外内容。目标引擎为 UE 5.8,API 以 5.8 头文件为准。
主要能力与用法:默认流程为先扫描、后访谈。第一步检查文件是否存在,若存在则作为上一版草稿读取;扫描 .uproject(EngineAssociation、Modules、Plugins、TargetPlatforms)、各 .Build.cs(模块名、Public/PrivateDependencyModuleNames、第三方路径、PublicDefinitions)、.Target.cs(TargetType、ExtraModuleNames、DefaultBuildSettings、平台条件)、Config/DefaultEngine.ini(GameMapsSettings 位于 EngineSettings 模块、RendererSettings)、DefaultGame.ini、DefaultInput.ini(EnhancedInput 与遗留映射)、DefaultGameplayTags.ini,以及 Plugins 下的 .uplugin;抽查 3–5 个 Public 头文件确认命名前缀、TObjectPtr 用法、API 宏风格、日志类别与断言策略。第二步向用户提出“草稿哪里错误、遗漏了什么”,只重新呈现变更部分,并逐项补齐无法从代码读出的信息,如 Gameplay 框架类名、网络模型、存档系统、AI 栈、团队与源码控制。第三步写入 .agents/ue-project-context.md(必要时创建 .agents/),顶部标注引擎版本与日期;刷新时保留未复查段落并更新日期。无 Source/ 树时改用回退问卷,按引擎与项目、模块、插件、约定、框架、GAS、网络、输入、UI、AI、流送、存档、构建、团队分组逐组确认。
适用场景与限制:适用于首次建立或刷新 UE 项目上下文文档,以及没有 C++ 源码的纯蓝图或空项目。输出文件模板包含引擎与项目、模块、插件、编码约定、Gameplay 框架、GAS、网络、输入、UI、AI、流送、存档、构建、团队等章节,无内容可省略。插件须记录 .uplugin 名而非显示名,并标注成熟度(如 Experimental、Beta);插件是否启用依据 .uproject 中 Enabled 字段,或默认启用且未被禁用,项目内 Plugins/ 插件若无 EnabledByDefault 键则默认启用。常见错误包括用问卷开场、猜测填空、写友好插件名、误判插件状态、把 GameMapsSettings 放在 Engine 模块下、遗漏成熟度与模块依赖。缺失字段须写 [unknown] 或“尚未确定”,不得编造。其他细节暂未提供。