feat(enemy): 未发现层/交战层/死亡层三个模块契约

Assets/_Game/Scripts/Enemies/AIBrain/Modules/IEngagementModule.cs

@@ -0,0 +1,31 @@
+using System;
+using BaseGames.AI;
+
+namespace BaseGames.Enemies
+{
+    /// <summary>
+    /// 交战层：发现玩家之后怎么打。骨架只认这四件事——从哪个态进、什么条件进、
+    /// 边标签是什么、内部怎么打。新增一种打法 = 新增一个实现，骨架与其他模块不受影响。
+    ///
+    /// CanEngage 归本模块所有是关键：像"冲锋冷却门"这种只对某一种打法有意义的条件，
+    /// 若留在骨架上就会变成骨架的开关字段，并与其他开关互相耦合。
+    ///
+    /// 实现注意：模块会经 [SerializeReference] 反序列化，构造函数不保证被调用。
+    /// 不要在构造函数里预计算缓存或做参数校验——缓存用惰性属性，校验放 Build()。
+    /// </summary>
+    public interface IEngagementModule
+    {
+        /// <summary>声明交战态与脱战边。</summary>
+        /// <param name="rest">脱战后回到的未发现态，由骨架传入。</param>
+        void Build(BrainBuilder b, string rest);
+
+        /// <summary>骨架从未发现态 / 警觉态连过来的目标。</summary>
+        string EntryState { get; }
+
+        /// <summary>进入交战的条件。惰性构建并缓存。</summary>
+        Func<IAiContext, bool> CanEngage { get; }
+
+        /// <summary>CanEngage 的可读标签（trace / 图导出用）。</summary>
+        string EngageLabel { get; }
+    }
+}